@seayoo-web/app-info 0.1.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seayoo-web/app-info",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "app info parser",
   "type": "module",
   "source": "./src/index.ts",

package/types/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./src/file.app";
 export * from "./src/file.apk";
 export * from "./src/file.ipa";
-export type { AppCommonInfo, ParserOptions, FileInput } from "./src/utils/base";
+export type { AppCommonInfo, ParserOptions, FileInput, OutputType } from "./src/utils/base";

package/types/src/file.apk.d.ts

@@ -1,15 +1,22 @@
-import type { AppCommonInfo, FileInput, ParserOptions } from "./utils/base";
-import type { Application, CollapsedAttributes, Manifest } from "./utils/manifest";
-export type { Manifest, CollapsedAttributes, CollapsedValue, Application, Provider, Component, IntentFilter, } from "./utils/manifest";
+import type { AppCommonInfo, FileInput, OutputByType, OutputType, ParserOptions } from "./utils/base";
+import type { Manifest } from "./utils/manifest";
+export type { Manifest, CollapsedAttributes, Application } from "./utils/manifest";
 /**
- * Android APK 应用信息接口
+ * Android APK 应用信息
  */
-export interface ApkInfo extends AppCommonInfo {
+export interface AndroidAppInfo extends AppCommonInfo {
     /** Manifest 信息 */
     manifest: Manifest;
-    /** Manifest.Application 信息 */
-    application?: Application;
-    /** Manifest.Application.metaData 信息 */
-    metaData?: CollapsedAttributes[];
 }
-export declare function parseApk(file: FileInput, options?: ParserOptions): Promise<ApkInfo | Error>;
+export declare class AndroidAppParser {
+    private zip;
+    constructor(file: FileInput);
+    parse(options?: ParserOptions): Promise<AndroidAppInfo | Error>;
+    /**
+     * 读取指定文件的内容
+     */
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
+}

package/types/src/file.app.d.ts

@@ -1,13 +1,19 @@
-import type { FileInput, AppCommonInfo, ParserOptions } from "./utils/base";
-import type { PackageInfo, Summary } from "./utils/pack.info";
-export type { HosAppPackInfo, Summary, PackageInfo, AppInfo, ModuleInfo, DeviceType } from "./utils/pack.info";
+import type { FileInput, AppCommonInfo, ParserOptions, OutputType, OutputByType } from "./utils/base";
+import type { HosAppPackInfo } from "./utils/pack.info";
+export type { HosAppPackInfo, Summary, PackageInfo, DeviceType } from "./utils/pack.info";
 export interface HosAppInfo extends AppCommonInfo {
-    /** 摘要信息 */
-    summary: Summary;
-    /** 包信息列表，描述各个模块的安装和交付配置  */
-    packages: PackageInfo[];
+    /** 包体信息 */
+    pack: HosAppPackInfo;
+}
+export declare class HosAppParser {
+    private zip;
+    constructor(file: FileInput);
+    parse(options?: ParserOptions): Promise<HosAppInfo | Error>;
+    /**
+     * 读取指定文件的内容
+     */
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
 }
-/**
- * 分析鸿蒙 app 应用的 pack.info 文件
- */
-export declare function parseHosApp(file: FileInput, options?: ParserOptions): Promise<HosAppInfo | Error>;

package/types/src/file.ipa.d.ts

@@ -1,29 +1,29 @@
-import type { AppCommonInfo, FileInput, ParserOptions } from "./utils/base";
+import type { AppCommonInfo, FileInput, OutputByType, OutputType, ParserOptions } from "./utils/base";
 import type { PlistInfo } from "./utils/plist";
-export type { PlistInfo, PlistValue } from "./utils/plist";
+export type { PlistInfo } from "./utils/plist";
 /**
  * iOS IPA 应用信息接口
  */
 export interface IosAppInfo extends AppCommonInfo {
     /** Info.plist 原始数据 */
-    plist?: PlistInfo;
-    /** 额外的模块 plist 信息  */
-    frameworks?: Record<string, PlistInfo | Error | undefined>;
-    /** 额外的文件信息 */
-    files?: Record<string, ArrayBuffer | Error | undefined>;
+    plist: PlistInfo;
 }
-/**
- * 解析 iOS IPA 文件
- * @param file IPA 文件输入
- * @returns Promise<IosAppInfo | Error>
- */
-export declare function parseIpa(file: FileInput, options?: ParserOptions & {
+export declare class IosAppParser {
+    private zip;
+    constructor(file: FileInput);
     /**
-     * 查找更多模块的 plist 信息，传入模块名称，比如 "ComboSDKSentry"
+     * 解析应用 plist 信息
      */
-    frameworks?: string[];
+    parse(options?: ParserOptions): Promise<IosAppInfo | Error>;
     /**
-     * 读取更多文件信息，比如 "ComboSDK.json"
+     * 读取指定模块的 plist 信息
      */
-    files?: string[];
-}): Promise<IosAppInfo | Error>;
+    parseFramework(name: string): Promise<PlistInfo | Error>;
+    /**
+     * 读取指定文件的内容
+     */
+    readFile<T extends OutputType>(filePath: string, output: T): Promise<{
+        name: string;
+        content: OutputByType[T];
+    } | Error>;
+}

package/types/src/utils/base.d.ts

@@ -1,8 +1,22 @@
+import type { PromiseValue } from "@seayoo-web/utils";
+import type { loadAsync } from "jszip";
 export type FileInput = Uint8Array | ArrayBuffer | Blob;
 export type ParserOptions = {
     /** 是否忽略图标，设置为 true 可以节约解析时间 */
     ignoreIcon?: boolean;
 };
+export type JSZip = PromiseValue<ReturnType<typeof loadAsync>>;
+export interface OutputByType {
+    base64: string;
+    string: string;
+    text: string;
+    binarystring: string;
+    array: number[];
+    uint8array: Uint8Array;
+    arraybuffer: ArrayBuffer;
+    blob: Blob;
+}
+export type OutputType = keyof OutputByType;
 export interface AppCommonInfo {
     /** 包名 */
     package: string;
@@ -12,8 +26,13 @@ export interface AppCommonInfo {
     versionName: string;
     /** dataURI 格式的图标 */
     icon?: string;
+    iconPath?: string;
 }
 export declare function toString(d: unknown): string;
 export declare function toNumber(d: unknown): number;
 export declare function formatError(e: unknown): Error;
 export declare function base64Icon(data: string): string;
+export declare function readFile<T extends keyof OutputByType>(zip: JSZip, filePath: string, output: T): Promise<{
+    name: string;
+    content: OutputByType[T];
+} | Error>;

package/types/src/utils/cgbi.d.ts

@@ -0,0 +1,18 @@
+/** CgBI PNG 处理工具*/
+/**
+ * 将 iOS CgBI PNG 转换为标准 PNG
+ * CgBI 是 iOS 特有的 PNG 优化格式，在 PNG 签名后插入了 CgBI 坊块
+ * 标准 PNG 解码器无法正确处理这种格式
+ *
+ * @param arrayBuffer - PNG 文件的 ArrayBuffer 数据
+ * @returns 修复后的 ArrayBuffer
+ */
+export declare function fixCgbiPng(arrayBuffer: ArrayBuffer): ArrayBuffer;
+/**
+ * 检查 ArrayBuffer 是否为 CgBI PNG
+ */
+export declare function isCgbiPng(arrayBuffer: ArrayBuffer): boolean;
+/**
+ * 将 ArrayBuffer 转换为 Base64 字符串
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;