zcw-shared 1.38.0 → 1.38.2

package/types/uniapp-ios-build.d.ts

@@ -129,3 +129,49 @@ export interface UniAppIOSBuildResult extends IOSBuildResult {
   // 可以添加 UniApp 特有的结果属性
 }
 
+/**
+ * UniApp iOS 插件开发构建选项
+ * 
+ * @description
+ * 专门用于 iOS 插件开发场景的构建选项，是 UniAppIOSBuildOptions 的简化版本。
+ * 与完整的应用打包相比，插件开发构建有以下区别：
+ * 1. 默认使用 Debug 配置
+ * 2. 始终启用自定义基座模式（buildCustomBase 隐式为 true）
+ * 3. 只构建到 archive，不导出 IPA（更快，适合开发调试）
+ * 4. 专门针对 HBuilder-uniPluginDemo 项目结构优化
+ * 
+ * @example
+ * ```typescript
+ * const options: UniAppIOSPluginBuildOptions = {
+ *   uniappProjectPath: '/path/to/uniapp/project',
+ *   projectPath: '/path/to/HBuilder-uniPluginDemo/HBuilder-Hello',
+ *   bundleId: 'com.example.app',
+ *   appkey: 'your-appkey',
+ *   configuration: 'Debug', // 可选，默认为 Debug
+ *   signing: {
+ *     teamId: 'XXXXXXXXXX'
+ *   },
+ *   nativePlugins: [
+ *     {
+ *       pluginPath: '/path/to/plugin.zip',
+ *       parameters: { appid: 'xxx' }
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export interface UniAppIOSPluginBuildOptions extends IOSBuildOptions {
+  /** UniApp 工程路径 */
+  uniappProjectPath: string
+  /** UniApp 编译结果路径（可选，如果提供则跳过构建步骤，直接使用此路径） */
+  uniappBuildOutputPath?: string
+  /** iOS Bundle Identifier */
+  bundleId?: string
+  /** UniApp 应用密钥 */
+  appkey?: string
+  /** 源码目录名称（可选，如果 .xcodeproj 文件名与实际源码目录不一致时需要指定，默认从 .xcodeproj 推断） */
+  sourceDirectoryName?: string
+  /** UniApp 原生插件配置列表（可选） */
+  nativePlugins?: UniAppNativePluginIOSOptions[]
+}
+