Feat/aab (#18)

* cleanup

* extractapk

# Conflicts:
#	src/package.ts

* use node bundletool

* Update version to 2.6.0 in package.json and enhance AAB parsing error messages with localized strings for better user feedback.

* Refactor app-info-parser: migrate ApkParser and AppParser to TypeScript, remove deprecated apk.js and app.js files, and update import statements for consistency.

* Refactor app-info-parser: migrate utility functions to TypeScript, remove deprecated utils.js, and enhance AAB and APK parsing with improved error handling and resource mapping.

* Implement AAB upload functionality: add uploadAab command to handle AAB file uploads, including options for split management and update documentation in README files. Remove deprecated .babelrc configuration.

* Enhance AAB parsing: add localized download hint for bundletool and improve error handling in runCommand function. Refactor command execution to support stdio options.

Author: sunnylqm

.babelrc

@@ -14,10 +14,10 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: oven-sh/setup-bun@v2
       # Setup .npmrc file to publish to npm
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: '24.x'
           registry-url: 'https://registry.npmjs.org'

.github/workflows/publish.yml

@@ -223,10 +223,12 @@ Each workflow step contains:
 
 - `uploadIpa`: Upload IPA files (supports `--version` to override extracted version)
 - `uploadApk`: Upload APK files (supports `--version` to override extracted version)
+- `uploadAab`: Upload AAB files (converted to APK, supports `--version`, `--includeAllSplits`, `--splits`)
 - `uploadApp`: Upload APP files (supports `--version` to override extracted version)
 - `parseApp`: Parse APP file information
 - `parseIpa`: Parse IPA file information
 - `parseApk`: Parse APK file information
+- `extractApk`: Extract a universal APK from an AAB (supports `--output`, `--includeAllSplits`, `--splits`)
 - `packages`: List packages
 
 ### User Module (`user`)

README.md

@@ -221,10 +221,12 @@ const workflowResult = await moduleManager.executeWorkflow('my-workflow', {
 
 - `uploadIpa`: 上传 IPA 文件（支持 `--version` 参数覆盖提取的版本）
 - `uploadApk`: 上传 APK 文件（支持 `--version` 参数覆盖提取的版本）
+- `uploadAab`: 上传 AAB 文件（转换为 APK，支持 `--version`、`--includeAllSplits`、`--splits`）
 - `uploadApp`: 上传 APP 文件（支持 `--version` 参数覆盖提取的版本）
 - `parseApp`: 解析 APP 文件信息
 - `parseIpa`: 解析 IPA 文件信息
 - `parseApk`: 解析 APK 文件信息
+- `extractApk`: 从 AAB 提取通用 APK（支持 `--output`、`--includeAllSplits`、`--splits`）
 - `packages`: 列出包
 
 ### User 模块 (`user`)

README.zh-CN.md

@@ -45,6 +45,19 @@
         }
       }
     },
+    "uploadAab": {
+      "options": {
+        "version": {
+          "hasValue": true
+        },
+        "includeAllSplits": {
+          "default": false
+        },
+        "splits": {
+          "hasValue": true
+        }
+      }
+    },
     "uploadApp": {
       "options": {
         "version": {
@@ -56,6 +69,19 @@
     "parseIpa": {},
     "parseApk": {},
     "parseAab": {},
+    "extractApk": {
+      "options": {
+        "output": {
+          "hasValue": true
+        },
+        "includeAllSplits": {
+          "default": false
+        },
+        "splits": {
+          "hasValue": true
+        }
+      }
+    },
     "packages": {
       "options": {
         "platform": {

cli.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-update-cli",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "command line tool for react-native-update (remote updates for react native)",
   "main": "index.js",
   "bin": {

package.json

@@ -6,21 +6,17 @@ import FormData from 'form-data';
 import fetch from 'node-fetch';
 import ProgressBar from 'progress';
 import tcpp from 'tcp-ping';
+import { getBaseUrl } from 'utils/http-helper';
 import packageJson from '../package.json';
 import type { Package, Session } from './types';
-import {
-  credentialFile,
-  pricingPageUrl,
-} from './utils/constants';
+import { credentialFile, pricingPageUrl } from './utils/constants';
 import { t } from './utils/i18n';
-import { getBaseUrl } from 'utils/http-helper';
 
 const tcpPing = util.promisify(tcpp.ping);
 
 let session: Session | undefined;
 let savedSession: Session | undefined;
 
-
 const userAgent = `react-native-update-cli/${packageJson.version}`;
 
 export const getSession = () => session;

src/api.ts

@@ -2,6 +2,18 @@ export default {
   addedToGitignore: 'Added {{line}} to .gitignore',
   androidCrunchPngsWarning:
     'The crunchPngs option of android seems not disabled (Please ignore this warning if already disabled), which may cause abnormal consumption of mobile network traffic. Please refer to https://cresc.dev/docs/getting-started#disable-crunchpngs-on-android \n',
+  aabOpenApksFailed: 'Failed to open generated .apks file',
+  aabReadUniversalApkFailed: 'Failed to read universal.apk',
+  aabUniversalApkNotFound: 'universal.apk not found in generated .apks',
+  aabBundletoolDownloadHint:
+    'bundletool not found. Downloading node-bundletool via npx (first run may take a while).',
+  aabManifestNotFound:
+    "AndroidManifest.xml can't be found in AAB base/manifest/",
+  aabParseResourcesWarning:
+    '[Warning] Failed to parse resources.arsc: {{error}}',
+  aabParseFailed: 'Failed to parse AAB: {{error}}',
+  aabParseManifestError: 'Parse AndroidManifest.xml error: {{error}}',
+  aabParseResourcesError: 'Parser resources.arsc error: {{error}}',
   appId: 'App ID',
   appIdMismatchApk:
     'App ID mismatch! Current APK: {{appIdInPkg}}, current update.json: {{appId}}',
@@ -116,10 +128,14 @@ This can reduce the risk of inconsistent dependencies and supply chain attacks.
   usageDiff: 'Usage: cresc {{command}} <origin> <next>',
   usageParseApk: 'Usage: cresc parseApk <apk file>',
   usageParseAab: 'Usage: cresc parseAab <aab file>',
+  usageExtractApk:
+    'Usage: cresc extractApk <aab file> [--output <apk file>] [--includeAllSplits] [--splits <split names>]',
   usageParseApp: 'Usage: cresc parseApp <app file>',
   usageParseIpa: 'Usage: cresc parseIpa <ipa file>',
   usageUnderDevelopment: 'Usage is under development now.',
   usageUploadApk: 'Usage: cresc uploadApk <apk file>',
+  usageUploadAab:
+    'Usage: cresc uploadAab <aab file> [--includeAllSplits] [--splits <split names>]',
   usageUploadApp: 'Usage: cresc uploadApp <app file>',
   usageUploadIpa: 'Usage: cresc uploadIpa <ipa file>',
   versionBind:
@@ -147,4 +163,5 @@ This can reduce the risk of inconsistent dependencies and supply chain attacks.
     'This function needs "node-bsdiff". Please run "{{scriptName}} install node-bsdiff" to install',
   nodeHdiffpatchRequired:
     'This function needs "node-hdiffpatch". Please run "{{scriptName}} install node-hdiffpatch" to install',
+  apkExtracted: 'APK extracted to {{output}}',
 };

src/locales/en.ts

@@ -2,6 +2,16 @@ export default {
   addedToGitignore: '已将 {{line}} 添加到 .gitignore',
   androidCrunchPngsWarning:
     'android 的 crunchPngs 选项似乎尚未禁用（如已禁用则请忽略此提示），这可能导致热更包体积异常增大，具体请参考 https://pushy.reactnative.cn/docs/getting-started.html#%E7%A6%81%E7%94%A8-android-%E7%9A%84-crunch-%E4%BC%98%E5%8C%96 \n',
+  aabOpenApksFailed: '无法打开生成的 .apks 文件',
+  aabReadUniversalApkFailed: '无法读取 universal.apk',
+  aabUniversalApkNotFound: '在生成的 .apks 中未找到 universal.apk',
+  aabBundletoolDownloadHint:
+    '未找到 bundletool，正在通过 npx 下载 node-bundletool（首次下载可能需要一些时间）。',
+  aabManifestNotFound: '在 AAB 的 base/manifest/ 中找不到 AndroidManifest.xml',
+  aabParseResourcesWarning: '[警告] 解析 resources.arsc 失败：{{error}}',
+  aabParseFailed: '解析 AAB 失败：{{error}}',
+  aabParseManifestError: '解析 AndroidManifest.xml 出错：{{error}}',
+  aabParseResourcesError: '解析 resources.arsc 出错：{{error}}',
   appId: '应用 id',
   appIdMismatchApk:
     'appId不匹配！当前apk: {{appIdInPkg}}, 当前update.json: {{appId}}',
@@ -110,9 +120,13 @@ export default {
   usageDiff: '用法：pushy {{command}} <origin> <next>',
   usageParseApk: '使用方法: pushy parseApk apk后缀文件',
   usageParseAab: '使用方法: pushy parseAab aab后缀文件',
+  usageExtractApk:
+    '使用方法: pushy extractApk aab后缀文件 [--output apk文件] [--includeAllSplits] [--splits 分包名列表]',
   usageParseApp: '使用方法: pushy parseApp app后缀文件',
   usageParseIpa: '使用方法: pushy parseIpa ipa后缀文件',
   usageUploadApk: '使用方法: pushy uploadApk apk后缀文件',
+  usageUploadAab:
+    '使用方法: pushy uploadAab aab后缀文件 [--includeAllSplits] [--splits 分包名列表]',
   usageUploadApp: '使用方法: pushy uploadApp app后缀文件',
   usageUploadIpa: '使用方法: pushy uploadIpa ipa后缀文件',
   versionBind:
@@ -138,4 +152,5 @@ export default {
     '此功能需要 "node-bsdiff"。请运行 "{{scriptName}} install node-bsdiff" 来安装',
   nodeHdiffpatchRequired:
     '此功能需要 "node-hdiffpatch"。请运行 "{{scriptName}} install node-hdiffpatch" 来安装',
+  apkExtracted: 'APK 已提取到 {{output}}',
 };

src/locales/zh.ts

@@ -1,4 +1,4 @@
-import type { CLIModule} from '../types';
+import type { CLIModule } from '../types';
 
 export const versionModule: CLIModule = {
   name: 'version',