@huoye/app-ship 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -10,15 +10,62 @@ interface UploadConfig {
     build?: {
         /** Android 构建配置 */
         android?: {
-            /** 构建产物类型：apk 或 appbundle */
+            /**
+             * 构建类型: apk 或 appbundle (aab)
+             * @default 'apk'
+             */
             type?: 'apk' | 'appbundle';
-            /** 构建风味（Flavor） */
+            /**
+             * 是否按 CPU 架构分开打包 (--split-per-abi)
+             * 将生成多个 APK (如 arm64 和 arm32)，自动适配多包上传
+             */
+            splitPerAbi?: boolean;
+            /**
+             * 是否开启 Dart 代码混淆 (--obfuscate)
+             */
+            obfuscate?: boolean;
+            /**
+             * 调试符号导出路径，开启混淆时必须配合使用
+             * @default 'build/debug-info'
+             */
+            splitDebugInfo?: string;
+            /**
+             * Dart 编译期环境变量注入 (-d)
+             */
+            dartDefines?: Record<string, string>;
+            /**
+             * 专家模式附加参数扩展（自动拼接到命令末尾）
+             */
+            extraArgs?: string[];
+            /**
+             * 完全自定义构建命令，配置此项后以上所有构建参数均失效
+             * 仅供具有极特殊构建场景的专家用户使用
+             */
+            customCommand?: string;
+            /** Product Flavor (--flavor) */
             flavor?: string;
-            /** 构建目标 */
+            /** Target platform/lib (--target) */
             target?: string;
-            /** 构建名称 */
+            /**
+             * 注入系统环境变量 (process.env)
+             */
+            envs?: Record<string, string>;
+            /**
+             * 构建前执行脚本
+             */
+            preBuild?: string;
+            /**
+             * 构建后执行脚本
+             */
+            postBuild?: string;
+            /**
+             * 是否在构建前执行 flutter clean
+             * @default false
+             */
+            clean?: boolean;
+            /** 版本名称 (覆盖 pubspec.yaml) */
             buildName?: string;
-            /** 构建号 */
+            /** 构建号 (覆盖 pubspec.yaml) */
             buildNumber?: string;
         };
         /** iOS 构建配置 */
@@ -31,6 +78,77 @@ interface UploadConfig {
             teamId?: string;
             /** 构建配置：Debug 或 Release */
             configuration?: string;
+            /** 是否使用 exportOptions.plist (默认自动生成命令) */
+            useExportOptions?: boolean;
+            /** 自定义导出配置文件路径 */
+            exportOptionsPlist?: string;
+            /**
+             * 是否开启 Dart 代码混淆 (--obfuscate)
+             */
+            obfuscate?: boolean;
+            /**
+             * 调试符号导出路径，开启混淆时必须配合使用
+             * @default 'build/debug-info'
+             */
+            splitDebugInfo?: string;
+            /**
+             * Dart 编译期环境变量注入 (-d)
+             */
+            dartDefines?: Record<string, string>;
+            /**
+             * 专家模式附加参数扩展（自动拼接到命令末尾）
+             */
+            extraArgs?: string[];
+            /**
+             * 完全自定义构建命令，配置此项后以上所有构建参数均失效
+             */
+            customCommand?: string;
+            /** Target platform/lib (--target) */
+            target?: string;
+            /**
+             * 注入系统环境变量 (process.env)
+             */
+            envs?: Record<string, string>;
+            /**
+             * 构建前执行脚本
+             */
+            preBuild?: string;
+            /**
+             * 构建后执行脚本
+             */
+            postBuild?: string;
+            /**
+             * 是否在构建前执行 flutter clean
+             * @default false
+             */
+            clean?: boolean;
+            /** 版本名称 (覆盖 pubspec.yaml) */
+            buildName?: string;
+            /** 构建号 (覆盖 pubspec.yaml) */
+            buildNumber?: string;
+        };
+        /** HarmonyOS 构建配置 */
+        harmony?: {
+            /** 构建类型: hap (调试/安装) 或 app (发布/应用) */
+            type?: 'hap' | 'app';
+            /** Dart 编译期环境变量注入 (-d) */
+            dartDefines?: Record<string, string>;
+            /** 注入系统环境变量 (process.env) */
+            envs?: Record<string, string>;
+            /** 构建前执行脚本 */
+            preBuild?: string;
+            /** 构建后执行脚本 */
+            postBuild?: string;
+            /** 是否在构建前执行 flutter clean */
+            clean?: boolean;
+            /** 附加参数 */
+            extraArgs?: string[];
+            /** 完全自定义构建命令 */
+            customCommand?: string;
+            /** 版本名称 */
+            buildName?: string;
+            /** 构建号 */
+            buildNumber?: string;
         };
     };
     /** 所有上传操作的重试配置 */
@@ -309,8 +427,10 @@ interface AppMetadata {
     changelog: string;
     /** 本次要上传到的平台列表 */
     platform?: string[];
-    /** 构建产物路径（apk/ipa） */
-    artifactPath?: string;
+    /** 构建产物路径（apk/ipa，支持 Record<ABI, Path> 形式以适配多架构） */
+    artifactPath?: string | Record<string, string>;
+    /** 按平台保留的产物集合，供上传调度层选择单包或多架构组合 */
+    platformArtifacts?: Record<string, string | Record<string, string>>;
     /** 全局工具链设置 */
     globalSettings?: {
         /** Android SDK 路径 */
@@ -375,12 +495,16 @@ interface IUploader {
 interface BuildResult {
     /** 是否成功 */
     success: boolean;
-    /** 构建产物路径 */
-    artifactPath: string;
+    /**
+     * 产物路径
+     * - 单包时返回路径字符串
+     * - 多架构分包时返回字典映射，如 { 'arm64-v8a': 'path/to/apk64', 'armeabi-v7a': 'path/to/apk32' }
+     */
+    artifactPath: string | Record<string, string>;
     /** 构建耗时（毫秒） */
     buildTime: number;
-    /** 平台：android | ios */
-    platform: 'android' | 'ios';
+    /** 平台：android | ios | harmony */
+    platform: 'android' | 'ios' | 'harmony';
 }
 
 declare class EnvValidator {
@@ -580,9 +704,6 @@ declare class XiaomiUploader implements IUploader {
         categoryName: string;
     }[] | null>;
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
-    /**
-     * 执行实际的上传操作
-     */
     private performUpload;
     /**
      * 解析公钥: 优先使用内容字段, 其次从文件路径读取
@@ -983,45 +1104,18 @@ declare class OppoUploader implements IUploader {
  *
  * 基于 vivo 开放平台「应用分发 API」实现 (协议与腾讯开放平台 Open-QQ 规范一致)
  * 文档: https://dev.vivo.com.cn/documentCenter/doc/326
- *
- * 上传流程:
- * 1. 使用 access_key + access_secret 生成签名
- * 2. 获取上传地址 (分段上传或直传)
- * 3. 上传 APK 文件
- * 4. 提交版本更新信息
- *
- * 签名方式: HMAC-SHA256(params_sorted, access_secret) → 16进制字符串
  */
 declare class VivoUploader implements IUploader {
     name: string;
     /** vivo 开放 API 基础地址 */
     private static readonly API_BASE;
-    /**
-     * vivo API 签名生成
-     * 规则: 所有参数按 ASCII 码排序后拼接为 key=val&... 字符串，
-     *       以 accessSecret 为密钥进行 HMAC-SHA256 加密，结果转为小写 16 进制字符串
-     */
     private generateSign;
     validateConfig(config: any): boolean;
     canHandle(filePath: string): boolean;
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
-    /**
-     * 计算文件 MD5
-     */
     private calculateFileMD5;
-    /**
-     * 上传 APK 文件并获取流水号
-     * 将公共参数与业务参数放入一个 multipart 请求中直接上传至 API_BASE
-     */
     private uploadApk;
-    /**
-     * 提交版本更新信息
-     */
     private submitVersion;
-    /**
-     * 格式化错误信息
-     */
-    private formatError;
 }
 
 /**
@@ -1187,6 +1281,12 @@ declare class UploadManager {
      * 上传到单个平台
      */
     private uploadToPlatform;
+    private shouldGroupArtifacts;
+    private resolveArtifactSelection;
+    private buildArtifactMapFromFiles;
+    private inferArtifactKey;
+    private getRepresentativeFilePath;
+    private validateArtifactSelection;
     /**
      * 聚合上传结果
      */

package/dist/index.d.ts

@@ -10,15 +10,62 @@ interface UploadConfig {
     build?: {
         /** Android 构建配置 */
         android?: {
-            /** 构建产物类型：apk 或 appbundle */
+            /**
+             * 构建类型: apk 或 appbundle (aab)
+             * @default 'apk'
+             */
             type?: 'apk' | 'appbundle';
-            /** 构建风味（Flavor） */
+            /**
+             * 是否按 CPU 架构分开打包 (--split-per-abi)
+             * 将生成多个 APK (如 arm64 和 arm32)，自动适配多包上传
+             */
+            splitPerAbi?: boolean;
+            /**
+             * 是否开启 Dart 代码混淆 (--obfuscate)
+             */
+            obfuscate?: boolean;
+            /**
+             * 调试符号导出路径，开启混淆时必须配合使用
+             * @default 'build/debug-info'
+             */
+            splitDebugInfo?: string;
+            /**
+             * Dart 编译期环境变量注入 (-d)
+             */
+            dartDefines?: Record<string, string>;
+            /**
+             * 专家模式附加参数扩展（自动拼接到命令末尾）
+             */
+            extraArgs?: string[];
+            /**
+             * 完全自定义构建命令，配置此项后以上所有构建参数均失效
+             * 仅供具有极特殊构建场景的专家用户使用
+             */
+            customCommand?: string;
+            /** Product Flavor (--flavor) */
             flavor?: string;
-            /** 构建目标 */
+            /** Target platform/lib (--target) */
             target?: string;
-            /** 构建名称 */
+            /**
+             * 注入系统环境变量 (process.env)
+             */
+            envs?: Record<string, string>;
+            /**
+             * 构建前执行脚本
+             */
+            preBuild?: string;
+            /**
+             * 构建后执行脚本
+             */
+            postBuild?: string;
+            /**
+             * 是否在构建前执行 flutter clean
+             * @default false
+             */
+            clean?: boolean;
+            /** 版本名称 (覆盖 pubspec.yaml) */
             buildName?: string;
-            /** 构建号 */
+            /** 构建号 (覆盖 pubspec.yaml) */
             buildNumber?: string;
         };
         /** iOS 构建配置 */
@@ -31,6 +78,77 @@ interface UploadConfig {
             teamId?: string;
             /** 构建配置：Debug 或 Release */
             configuration?: string;
+            /** 是否使用 exportOptions.plist (默认自动生成命令) */
+            useExportOptions?: boolean;
+            /** 自定义导出配置文件路径 */
+            exportOptionsPlist?: string;
+            /**
+             * 是否开启 Dart 代码混淆 (--obfuscate)
+             */
+            obfuscate?: boolean;
+            /**
+             * 调试符号导出路径，开启混淆时必须配合使用
+             * @default 'build/debug-info'
+             */
+            splitDebugInfo?: string;
+            /**
+             * Dart 编译期环境变量注入 (-d)
+             */
+            dartDefines?: Record<string, string>;
+            /**
+             * 专家模式附加参数扩展（自动拼接到命令末尾）
+             */
+            extraArgs?: string[];
+            /**
+             * 完全自定义构建命令，配置此项后以上所有构建参数均失效
+             */
+            customCommand?: string;
+            /** Target platform/lib (--target) */
+            target?: string;
+            /**
+             * 注入系统环境变量 (process.env)
+             */
+            envs?: Record<string, string>;
+            /**
+             * 构建前执行脚本
+             */
+            preBuild?: string;
+            /**
+             * 构建后执行脚本
+             */
+            postBuild?: string;
+            /**
+             * 是否在构建前执行 flutter clean
+             * @default false
+             */
+            clean?: boolean;
+            /** 版本名称 (覆盖 pubspec.yaml) */
+            buildName?: string;
+            /** 构建号 (覆盖 pubspec.yaml) */
+            buildNumber?: string;
+        };
+        /** HarmonyOS 构建配置 */
+        harmony?: {
+            /** 构建类型: hap (调试/安装) 或 app (发布/应用) */
+            type?: 'hap' | 'app';
+            /** Dart 编译期环境变量注入 (-d) */
+            dartDefines?: Record<string, string>;
+            /** 注入系统环境变量 (process.env) */
+            envs?: Record<string, string>;
+            /** 构建前执行脚本 */
+            preBuild?: string;
+            /** 构建后执行脚本 */
+            postBuild?: string;
+            /** 是否在构建前执行 flutter clean */
+            clean?: boolean;
+            /** 附加参数 */
+            extraArgs?: string[];
+            /** 完全自定义构建命令 */
+            customCommand?: string;
+            /** 版本名称 */
+            buildName?: string;
+            /** 构建号 */
+            buildNumber?: string;
         };
     };
     /** 所有上传操作的重试配置 */
@@ -309,8 +427,10 @@ interface AppMetadata {
     changelog: string;
     /** 本次要上传到的平台列表 */
     platform?: string[];
-    /** 构建产物路径（apk/ipa） */
-    artifactPath?: string;
+    /** 构建产物路径（apk/ipa，支持 Record<ABI, Path> 形式以适配多架构） */
+    artifactPath?: string | Record<string, string>;
+    /** 按平台保留的产物集合，供上传调度层选择单包或多架构组合 */
+    platformArtifacts?: Record<string, string | Record<string, string>>;
     /** 全局工具链设置 */
     globalSettings?: {
         /** Android SDK 路径 */
@@ -375,12 +495,16 @@ interface IUploader {
 interface BuildResult {
     /** 是否成功 */
     success: boolean;
-    /** 构建产物路径 */
-    artifactPath: string;
+    /**
+     * 产物路径
+     * - 单包时返回路径字符串
+     * - 多架构分包时返回字典映射，如 { 'arm64-v8a': 'path/to/apk64', 'armeabi-v7a': 'path/to/apk32' }
+     */
+    artifactPath: string | Record<string, string>;
     /** 构建耗时（毫秒） */
     buildTime: number;
-    /** 平台：android | ios */
-    platform: 'android' | 'ios';
+    /** 平台：android | ios | harmony */
+    platform: 'android' | 'ios' | 'harmony';
 }
 
 declare class EnvValidator {
@@ -580,9 +704,6 @@ declare class XiaomiUploader implements IUploader {
         categoryName: string;
     }[] | null>;
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
-    /**
-     * 执行实际的上传操作
-     */
     private performUpload;
     /**
      * 解析公钥: 优先使用内容字段, 其次从文件路径读取
@@ -983,45 +1104,18 @@ declare class OppoUploader implements IUploader {
  *
  * 基于 vivo 开放平台「应用分发 API」实现 (协议与腾讯开放平台 Open-QQ 规范一致)
  * 文档: https://dev.vivo.com.cn/documentCenter/doc/326
- *
- * 上传流程:
- * 1. 使用 access_key + access_secret 生成签名
- * 2. 获取上传地址 (分段上传或直传)
- * 3. 上传 APK 文件
- * 4. 提交版本更新信息
- *
- * 签名方式: HMAC-SHA256(params_sorted, access_secret) → 16进制字符串
  */
 declare class VivoUploader implements IUploader {
     name: string;
     /** vivo 开放 API 基础地址 */
     private static readonly API_BASE;
-    /**
-     * vivo API 签名生成
-     * 规则: 所有参数按 ASCII 码排序后拼接为 key=val&... 字符串，
-     *       以 accessSecret 为密钥进行 HMAC-SHA256 加密，结果转为小写 16 进制字符串
-     */
     private generateSign;
     validateConfig(config: any): boolean;
     canHandle(filePath: string): boolean;
     upload(filePath: string, config: any, metadata: AppMetadata): Promise<UploadResult>;
-    /**
-     * 计算文件 MD5
-     */
     private calculateFileMD5;
-    /**
-     * 上传 APK 文件并获取流水号
-     * 将公共参数与业务参数放入一个 multipart 请求中直接上传至 API_BASE
-     */
     private uploadApk;
-    /**
-     * 提交版本更新信息
-     */
     private submitVersion;
-    /**
-     * 格式化错误信息
-     */
-    private formatError;
 }
 
 /**
@@ -1187,6 +1281,12 @@ declare class UploadManager {
      * 上传到单个平台
      */
     private uploadToPlatform;
+    private shouldGroupArtifacts;
+    private resolveArtifactSelection;
+    private buildArtifactMapFromFiles;
+    private inferArtifactKey;
+    private getRepresentativeFilePath;
+    private validateArtifactSelection;
     /**
      * 聚合上传结果
      */