zcw-shared 1.38.2 → 1.40.1

package/types/hybrid.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Hybrid 跨端通信类型定义
+ */
+
+/**
+ * 运行环境类型
+ */
+export type Environment = 'h5' | 'miniapp' | 'app' | 'unknown'
+
+/**
+ * 通信方向
+ */
+export type BridgeDirection = 'h5-to-miniapp' | 'h5-to-app' | 'miniapp-to-h5' | 'app-to-h5'
+
+/**
+ * 消息类型
+ */
+export type MessageType = 'request' | 'response' | 'event' | 'error'
+
+/**
+ * 通信消息基础结构
+ */
+export interface BaseMessage {
+  id: string                    // 消息ID，用于请求-响应匹配
+  type: MessageType            // 消息类型
+  action: string               // 操作类型：'share', 'login', 'pay'...
+  method?: string              // 具体方法：'setShare', 'triggerShare'...
+  timestamp: number            // 时间戳
+}
+
+/**
+ * 请求消息
+ */
+export interface RequestMessage extends BaseMessage {
+  type: 'request'
+  method: string               // 请求必须有方法
+  params?: any                  // 请求参数
+}
+
+/**
+ * 响应消息
+ */
+export interface ResponseMessage extends BaseMessage {
+  type: 'response'
+  success: boolean             // 是否成功
+  data?: any                   // 响应数据
+  error?: {                    // 错误信息
+    code: string | number
+    message: string
+    details?: any
+  }
+}
+
+/**
+ * 事件消息
+ */
+export interface EventMessage extends BaseMessage {
+  type: 'event'
+  event: string                // 事件名称
+  data?: any                   // 事件数据
+}
+
+/**
+ * 错误消息
+ */
+export interface ErrorMessage extends BaseMessage {
+  type: 'error'
+  error: {
+    code: string | number
+    message: string
+    details?: any
+  }
+}
+
+/**
+ * 所有消息类型的联合
+ */
+export type BridgeMessage = RequestMessage | ResponseMessage | EventMessage | ErrorMessage
+
+/**
+ * 消息处理器类型
+ */
+export type MessageHandler = (message: BridgeMessage) => void | Promise<void>
+
+/**
+ * 事件监听器类型
+ */
+export type EventListener = (data?: any) => void
+
+/**
+ * 平台 API 依赖接口
+ */
+export interface PlatformDeps {
+  window: {
+    wx?: any
+    uni?: any
+    plus?: any
+    document: {
+      createElement: (tag: string) => any
+      querySelector: (selector: string) => any
+      head: { appendChild: (el: any) => any }
+    }
+    location: {
+      origin: string
+      href: string
+    }
+    self: any
+    top: any
+    parent: any
+  }
+  navigator: {
+    userAgent: string
+  }
+  isServer: () => boolean
+  setTimeout: (callback: () => void, ms: number) => any
+  clearTimeout: (id: any) => void
+  setInterval: (callback: () => void, ms: number) => any
+  clearInterval: (id: any) => void
+}

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

@@ -184,4 +184,29 @@ export interface UniAppAndroidBuildOptions extends AndroidBuildOptions {
  */
 export interface UniAppAndroidBuildResult extends AndroidBuildResult {
   // 可以添加 UniApp 特有的结果属性
+}
+
+/**
+ * UniApp Android 插件开发构建选项
+ * 
+ * @description
+ * 这是 UniAppAndroidBuildOptions 的简化版本，专门用于 Android 插件开发场景。
+ * 与完整的应用打包相比，插件开发构建有以下特点：
+ * 1. 始终使用 Debug 配置（除非明确指定）
+ * 2. 始终启用自定义基座模式
+ * 3. 专门针对 UniPlugin-Hello-AS 项目结构优化
+ */
+export interface UniAppAndroidPluginBuildOptions extends Omit<UniAppAndroidBuildOptions, 'buildCustomBase' | 'buildVariant'> {
+  /** 构建类型（可选，默认为 'debug'） */
+  buildVariant?: 'debug' | 'release'
+  /** 不包含第三方登录/分享配置（插件开发通常不需要） */
+  wechatLogin?: never
+  wechatShare?: never
+  univerifyLogin?: never
+  qqLogin?: never
+  sinaLogin?: never
+  miuiLogin?: never
+  googleLogin?: never
+  facebookLogin?: never
+  shareTrace?: never
 }