Feat/aab

.github/workflows/publish.yml

@@ -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'

README.md

@@ -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.zh-CN.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`)

cli.json

@@ -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": {

package.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": {

src/api.ts

@@ -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/locales/en.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/zh.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/modules/version-module.ts

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

src/package.ts

@@ -1,17 +1,25 @@
-import { get, getAllPackages, post, uploadFile, doDelete } from './api';
-import { question, saveToLocal } from './utils';
-import { t } from './utils/i18n';
-
-import { getPlatform, getSelectedApp } from './app';
-
+import os from 'os';
+import path from 'path';
+import fs from 'fs-extra';
 import Table from 'tty-table';
+import { doDelete, getAllPackages, post, uploadFile } from './api';
+import { getPlatform, getSelectedApp } from './app';
 import type { Platform } from './types';
-import { getApkInfo, getAppInfo, getIpaInfo, getAabInfo } from './utils';
+import {
+  getAabInfo,
+  getApkInfo,
+  getAppInfo,
+  getIpaInfo,
+  question,
+  saveToLocal,
+} from './utils';
+import { AabParser } from './utils/app-info-parser/aab';
 import { depVersions } from './utils/dep-versions';
 import { getCommitInfo } from './utils/git';
+import { t } from './utils/i18n';
 
 export async function listPackage(appId: string) {
-  const allPkgs = await getAllPackages(appId);
+  const allPkgs = (await getAllPackages(appId)) || [];
 
   const header = [
     { value: t('nativePackageId') },
@@ -49,7 +57,7 @@ export async function choosePackage(appId: string) {
 
   while (true) {
     const id = await question(t('enterNativePackageId'));
-    const app = list.find((v) => v.id.toString() === id);
+    const app = list?.find((v) => v.id.toString() === id);
     if (app) {
       return app;
     }
@@ -143,6 +151,48 @@ export const packageCommands = {
     saveToLocal(fn, `${appId}/package/${id}.apk`);
     console.log(t('apkUploadSuccess', { id, version: versionName, buildTime }));
   },
+  uploadAab: async ({
+    args,
+    options,
+  }: {
+    args: string[];
+    options: Record<string, any>;
+  }) => {
+    const source = args[0];
+    if (!source || !source.endsWith('.aab')) {
+      throw new Error(t('usageUploadAab'));
+    }
+
+    const output = path.join(
+      os.tmpdir(),
+      `${path.basename(source, path.extname(source))}-${Date.now()}.apk`,
+    );
+
+    const includeAllSplits =
+      options.includeAllSplits === true || options.includeAllSplits === 'true';
+    const splits = options.splits
+      ? String(options.splits)
+          .split(',')
+          .map((item) => item.trim())
+          .filter(Boolean)
+      : null;
+
+    const parser = new AabParser(source);
+    try {
+      await parser.extractApk(output, {
+        includeAllSplits,
+        splits,
+      });
+      await packageCommands.uploadApk({
+        args: [output],
+        options,
+      });
+    } finally {
+      if (await fs.pathExists(output)) {
+        await fs.remove(output);
+      }
+    }
+  },
   uploadApp: async ({
     args,
     options,
@@ -214,6 +264,42 @@ export const packageCommands = {
     }
     console.log(await getAabInfo(fn));
   },
+  extractApk: async ({
+    args,
+    options,
+  }: {
+    args: string[];
+    options: Record<string, any>;
+  }) => {
+    const source = args[0];
+    if (!source || !source.endsWith('.aab')) {
+      throw new Error(t('usageExtractApk'));
+    }
+
+    const output =
+      options.output ||
+      path.join(
+        path.dirname(source),
+        `${path.basename(source, path.extname(source))}.apk`,
+      );
+
+    const includeAllSplits =
+      options.includeAllSplits === true || options.includeAllSplits === 'true';
+    const splits = options.splits
+      ? String(options.splits)
+          .split(',')
+          .map((item) => item.trim())
+          .filter(Boolean)
+      : null;
+
+    const parser = new AabParser(source);
+    await parser.extractApk(output, {
+      includeAllSplits,
+      splits,
+    });
+
+    console.log(t('apkExtracted', { output }));
+  },
   packages: async ({ options }: { options: { platform: Platform } }) => {
     const platform = await getPlatform(options.platform);
     const { appId } = await getSelectedApp(platform);
@@ -224,7 +310,12 @@ export const packageCommands = {
     options,
   }: {
     args: string[];
-    options: { appId?: string; packageId?: string; packageVersion?: string; platform?: Platform };
+    options: {
+      appId?: string;
+      packageId?: string;
+      packageVersion?: string;
+      platform?: Platform;
+    };
   }) => {
     let { appId, packageId, packageVersion } = options;
 

src/provider.ts

@@ -122,6 +122,9 @@ export class CLIProviderImpl implements CLIProvider {
         case 'apk':
           await packageCommands.uploadApk(context);
           break;
+        case 'aab':
+          await packageCommands.uploadAab(context);
+          break;
         case 'app':
           await packageCommands.uploadApp(context);
           break;