@hd-front-end/jsbridge-sdk 1.0.2 → 1.0.4

package/README.md

@@ -29,7 +29,7 @@ npm install @hd-front-end/jsbridge-sdk
 ### 基础使用
 
 ```typescript
-import { init, JSBridge } from '@hd/jsbridge-sdk'
+import { init, JSBridge } from '@hd-front-end/jsbridge-sdk'
 
 // 初始化
 await init({
@@ -83,6 +83,7 @@ if (process.env.NODE_ENV === 'development') {
 
 - [平台兼容性说明.md](./docs/平台兼容性说明.md) - Android/iOS 兼容
 - [监控指南.md](./docs/监控指南.md) - 监控使用指南
+- [新增桥接能力扩展说明.md](./docs/07-新桥接方法扩展说明.md) - **新集成的业务级桥接能力及 UniApp 适配方法说明**
 - [更新日志.md](./docs/更新日志.md) - 版本演进历史
 - [关键问题解答.md](./docs/关键问题解答.md) - 核心问题解答
 
@@ -101,7 +102,7 @@ if (process.env.NODE_ENV === 'development') {
 └─────────────────────────────────────┘
             ↓
 ┌─────────────────────────────────────┐
-│  @hd/jsbridge-sdk                   │
+│  @hd-front-end/jsbridge-sdk                   │
 │  ├── 核心通信（Android/iOS）         │
 │  ├── API 层（device/media/log...）  │
 │  ├── 监控层（通过 log 上报）         │
@@ -141,3 +142,4 @@ const info = await JSBridge.getDeviceInfo()
 await JSBridge.log.info('操作成功', 'Business')
 await JSBridge.log.error('接口异常', 'Network', { status: 500 })
 ```
+

package/dist/index.d.ts

@@ -148,6 +148,7 @@ declare global {
         };
     }
 }
+type Nullable$1<T> = T | null | undefined;
 
 /**
  * 日志 API
@@ -398,6 +399,204 @@ declare function onPdaScan(handler: (data: any, callback: (response: any) => voi
  */
 declare function logout(): Promise<void>;
 
+declare function hdH5Adapter(): void;
+
+declare const UniProxy: any;
+
+declare class PageLifeCycle {
+    state: string;
+    route: any;
+    constructor(state: string, route: any);
+}
+
+declare class UniScanRequest {
+    scanType: string[];
+    hideAlbum: boolean;
+    language: string;
+    failedMsg: string;
+    screenType: string;
+    timeoutInterval: string;
+    timeoutText: string;
+    viewText: string;
+}
+
+declare class UniScanResult {
+    resp_result: Nullable<string>;
+    resp_code: number;
+    resp_message: Nullable<string>;
+}
+
+declare class UniChooseMediaRequest {
+    extension: string[];
+    sourceType: string[];
+    camera: string;
+    mediaType: string[];
+    count: number;
+    maxDuration: number;
+    sizeType: string[];
+}
+
+declare class UniMediaFile {
+    tempFilePath: string;
+    name: string;
+    fileType: string;
+    size: number;
+    width: number;
+    height: number;
+    duration: number;
+    thumbTempFilePath?: string;
+}
+
+declare class UniChooseMediaResult {
+    tempFiles: UniMediaFile[];
+    tempFilePaths: string[];
+}
+
+declare class ImageInfoRequest {
+    src: string;
+}
+
+declare class UniUploadFileResult {
+    code: number;
+    errMsg: Nullable<string>;
+    data: Nullable<string>;
+    statusCode: Nullable<number>;
+}
+
+declare class UniPhoneCall {
+    phoneNumber: string;
+}
+
+declare class UniNavigationBarStyle {
+    title: Nullable<string>;
+    frontColor: Nullable<string>;
+    backgroundColor: Nullable<string>;
+}
+
+declare class UniLog {
+    tag: Nullable<string>;
+    level: string;
+    message: string;
+}
+
+interface UniUrlScheme {
+    url: string;
+    openType?: 'APP' | 'SYSTEM';
+    style?: any;
+}
+
+interface UniReloadModule {
+    appId: string;
+}
+
+declare class JsBridgeHandlers {
+    /**
+     * 路由变化通知原生
+     * @param to
+     * @param from
+     */
+    static handleRouterAfterEach(to: any, from: any): Promise<any>;
+    /**
+     * 获取app端信息
+     */
+    static handleGetAppInfo(): Promise<any>;
+    /**
+     * 页面生命周期通知原生
+     * @param lifecycle
+     */
+    static handlePageLifeCycle(lifecycle: PageLifeCycle): Promise<any>;
+    /**
+     * 注册路由跳转调用
+     * @param handler
+     */
+    static registerOnRoute(handler: (data: any, responseCallback: any) => void): Promise<void>;
+    /**
+     * 注册获取路由信息调用
+     */
+    static registerOnGetRouteInfo(handler: (data: any, responseCallback: any) => void): Promise<void>;
+    /**
+     * 注册刷新store数据
+     * @param handler
+     */
+    static registerOnRefreshStore(handler: (data: any, responseCallback: any) => void): Promise<void>;
+    /**
+     * 注册PDA扫码回调
+     * @param handler
+     */
+    static registerOnPdaScan(handler: (data: any, responseCallback: any) => void): Promise<void>;
+    /**
+     * 调用原生扫码
+     * @param request
+     */
+    static handleScan(request?: UniScanRequest): Promise<UniScanResult>;
+    /**
+     * 调用原生选择图片/视频
+     * @param request
+     */
+    static handleChooseMedia(request: UniChooseMediaRequest): Promise<Nullable<UniChooseMediaResult>>;
+    /**
+     * 获取图片信息
+     * @param request
+     */
+    static handleGetImageInfo(request: ImageInfoRequest): Promise<UniMediaFile>;
+    /**
+     * 上传文件
+     * @param request
+     */
+    static handleUploadFile(request: UniApp.UploadFileOption): Promise<UniUploadFileResult>;
+    /**
+     * 关闭当前WebView
+     * @param request
+     */
+    static handleCloseWebView(): Promise<void>;
+    /**
+     * 打电话
+     * @param request
+     */
+    static handleMakePhoneCall(request: UniPhoneCall): Promise<any>;
+    /**
+     * 动态设置标题
+     * @param request
+     */
+    static handleSetNavigationBar(request: UniNavigationBarStyle): Promise<void>;
+    /**
+     * 打日志
+     * @param request
+     */
+    static handleLog(request: UniLog): Promise<void>;
+    /**
+     * 通知原生APP已加载完成
+     * @param data
+     */
+    static handleAppOnload(data: any): Promise<void>;
+    /**
+     * 通知原生APP退出登录
+     * @param data
+     */
+    static handleLogout(): Promise<void>;
+    /**
+     * 通知原生APP打开链接
+     * @param data
+     */
+    static handleOpenSchemeUrl(request: UniUrlScheme): Promise<string>;
+    /**
+     * 图片路径转换成base64格式
+     * @param path
+     */
+    static handlePathToBase64(request: ImageInfoRequest): Promise<string>;
+    static handleBluetoothPrintImage(request: any): Promise<any>;
+    /**
+     * 蓝牙打印
+     * @param data
+     */
+    static handleBluetoothPrint(request: any): Promise<any>;
+    /**
+     * 通知原生APP重新加载子应用
+     * @param request
+     */
+    static handleReloadModule(request: UniReloadModule): Promise<void>;
+}
+
 /**
  * 初始化 JSBridge SDK
  *
@@ -641,5 +840,5 @@ declare const Debug: {
     clearLogs: () => void;
 };
 
-export { Debug, JSBridge, LogLevel, Monitor, getPlatform, inApp, init, isReady };
-export type { AppInfo, ChooseMediaRequest, ChooseMediaResult, DebugConfig, DebugLog, DeviceInfo, ImageInfo, JSBridgeConfig, LogRequest, MediaFile, MonitorConfig, MonitorRecord, MonitorStats, NavigationBarStyle, NetworkInfo, PhoneCallRequest, Platform, PrintRequest, RouteInfo, ScanRequest, ScanResult, StorageData, UploadFileRequest, UploadFileResult };
+export { Debug, JSBridge, JsBridgeHandlers, LogLevel, Monitor, UniProxy, getPlatform, hdH5Adapter, inApp, init, isReady };
+export type { AppInfo, ChooseMediaRequest, ChooseMediaResult, DebugConfig, DebugLog, DeviceInfo, ImageInfo, JSBridgeConfig, LogRequest, MediaFile, MonitorConfig, MonitorRecord, MonitorStats, NavigationBarStyle, NetworkInfo, Nullable$1 as Nullable, PhoneCallRequest, Platform, PrintRequest, RouteInfo, ScanRequest, ScanResult, StorageData, UploadFileRequest, UploadFileResult };

package/dist/index.esm.js

@@ -1339,6 +1339,449 @@ async function logout() {
     }
 }
 
+class PageLifeCycle {
+    constructor(state, route) {
+        this.state = state;
+        this.route = route;
+    }
+}
+
+class UniScanRequest {
+    constructor() {
+        this.scanType = ['qrCode', 'barCode']; // 扫码识别类型，参数可多选，qrCode、barCode，不设置，默认识别所有
+        this.hideAlbum = false; // 是否隐藏相册，默认false不隐藏
+        this.language = 'zh-Hans'; // ios需要设置这个参数，只支持中英文 zh-Hans、en，默认中文
+        this.failedMsg = '未识别到二维码，请重试'; // 相册选择照片识别错误提示(ios)
+        this.screenType = 'full'; // Android支持全屏需要设置此参数
+        this.timeoutInterval = '10'; // 设置超时时间，单位秒，默认10秒
+        this.timeoutText = '未识别到二维码？'; // 超时提醒文本，默认未识别到二维码?
+        this.viewText = '扫二维码/条码'; // 扫码提示文字，设置null时显示sdk默认文案
+    }
+}
+
+class UniScanResult {
+}
+
+class JsBridgeHandlers {
+    /**
+     * 路由变化通知原生
+     * @param to
+     * @param from
+     */
+    static handleRouterAfterEach(to, from) {
+        return bridge.call('routerAfterEach', { to, from });
+    }
+    /**
+     * 获取app端信息
+     */
+    static handleGetAppInfo() {
+        return bridge.call('getAppInfo');
+    }
+    /**
+     * 页面生命周期通知原生
+     * @param lifecycle
+     */
+    static handlePageLifeCycle(lifecycle) {
+        return bridge.call('uniPageLifeCycle', lifecycle);
+    }
+    /**
+     * 注册路由跳转调用
+     * @param handler
+     */
+    static registerOnRoute(handler) {
+        return bridge.register('route', handler);
+    }
+    /**
+     * 注册获取路由信息调用
+     */
+    static registerOnGetRouteInfo(handler) {
+        return bridge.register('getRouteInfo', handler);
+    }
+    /**
+     * 注册刷新store数据
+     * @param handler
+     */
+    static registerOnRefreshStore(handler) {
+        return bridge.register('refreshStore', handler);
+    }
+    /**
+     * 注册PDA扫码回调
+     * @param handler
+     */
+    static registerOnPdaScan(handler) {
+        return bridge.register('pdaScan', handler);
+    }
+    /**
+     * 调用原生扫码
+     * @param request
+     */
+    static handleScan(request = new UniScanRequest()) {
+        return bridge.call('scan', request).then((res) => {
+            const json = JSON.parse(res);
+            const result = new UniScanResult();
+            // eslint-disable-next-line @typescript-eslint/camelcase
+            result.resp_code = json.resp_code;
+            // eslint-disable-next-line @typescript-eslint/camelcase
+            result.resp_result = json.resp_result;
+            // eslint-disable-next-line @typescript-eslint/camelcase
+            result.resp_message = json.resp_message;
+            return result;
+        });
+    }
+    /**
+     * 调用原生选择图片/视频
+     * @param request
+     */
+    static handleChooseMedia(request) {
+        return bridge.call('chooseMedia', request).then((res) => {
+            if (res) {
+                const result = JSON.parse(res);
+                return result;
+            }
+            else
+                return null;
+        });
+    }
+    /**
+     * 获取图片信息
+     * @param request
+     */
+    static handleGetImageInfo(request) {
+        return bridge.call('getImageInfo', request).then((res) => {
+            const result = JSON.parse(res);
+            return result;
+        });
+    }
+    /**
+     * 上传文件
+     * @param request
+     */
+    static handleUploadFile(request) {
+        return bridge.call('uploadFile', request).then((res) => {
+            const result = JSON.parse(res);
+            return result;
+        });
+    }
+    /**
+     * 关闭当前WebView
+     * @param request
+     */
+    static handleCloseWebView() {
+        return bridge.call('closeWebView');
+    }
+    /**
+     * 打电话
+     * @param request
+     */
+    static handleMakePhoneCall(request) {
+        return bridge.call('makePhoneCall', request);
+    }
+    /**
+     * 动态设置标题
+     * @param request
+     */
+    static handleSetNavigationBar(request) {
+        return bridge.call('setNavigationBar', request);
+    }
+    /**
+     * 打日志
+     * @param request
+     */
+    static handleLog(request) {
+        return bridge.call('log', request);
+    }
+    /**
+     * 通知原生APP已加载完成
+     * @param data
+     */
+    static handleAppOnload(data) {
+        return JsBridgeHandlers.handlePageLifeCycle(new PageLifeCycle('appOnLaunch', data));
+    }
+    /**
+     * 通知原生APP退出登录
+     * @param data
+     */
+    static handleLogout() {
+        return bridge.call('logout');
+    }
+    /**
+     * 通知原生APP打开链接
+     * @param data
+     */
+    static handleOpenSchemeUrl(request) {
+        return bridge.call('openSchemeUrl', request);
+    }
+    /**
+     * 图片路径转换成base64格式
+     * @param path
+     */
+    static handlePathToBase64(request) {
+        return bridge.call('pathToBase64', request).then((res) => {
+            const result = JSON.parse(res);
+            return result;
+        });
+    }
+    static handleBluetoothPrintImage(request) {
+        console.log(request);
+        return bridge.call('printImage', request).then((res) => {
+            if (!res)
+                return res;
+            if (typeof res === 'string') {
+                try {
+                    return JSON.parse(res);
+                }
+                catch (e) {
+                    return res;
+                }
+            }
+            return res;
+        });
+    }
+    /**
+     * 蓝牙打印
+     * @param data
+     */
+    static handleBluetoothPrint(request) {
+        return bridge.call('bluetoothPrint', request).then((res) => {
+            if (!res)
+                return res;
+            if (typeof res === 'string') {
+                try {
+                    return JSON.parse(res);
+                }
+                catch (e) {
+                    return res;
+                }
+            }
+            return res;
+        });
+    }
+    /**
+     * 通知原生APP重新加载子应用
+     * @param request
+     */
+    static handleReloadModule(request) {
+        return bridge.call('reloadModule', request);
+    }
+}
+
+// 为什么会有这个类？
+//uni.chooseImage = chooseImage
+//Cannot assign to read only property 'chooseImage' of object '[object Object]'
+// chooseImage是只读的，无法替换，只能用代理模式，如果有好方法替换可以删除这个类
+const UniProxy = {
+    chooseImage: typeof uni !== 'undefined' ? uni.chooseImage : null,
+    pathToBase64: null
+};
+
+function hdH5Adapter() {
+    uni.scanCode = (options) => {
+        const mpaasScanOptions = {
+            scanType: options.scanType || ['qrCode', 'barCode'],
+            hideAlbum: options.onlyFromCamera || false,
+            viewText: '扫二维码/条码',
+            language: 'zh-Hans',
+            failedMsg: '未识别到二维码，请重试',
+            screenType: 'full',
+            timeoutInterval: '10',
+            timeoutText: '未识别到二维码？'
+        };
+        JsBridgeHandlers.handleScan(mpaasScanOptions).then((ret) => {
+            var _a, _b, _c, _d;
+            if (ret.resp_code === 1000) {
+                (_a = options.success) === null || _a === void 0 ? void 0 : _a.call(options, {
+                    result: ret.resp_result || '',
+                    scanType: mpaasScanOptions.scanType[0],
+                    charSet: 'utf-8',
+                    path: ''
+                });
+            }
+            else if (ret.resp_code === 10) {
+                (_b = options.fail) === null || _b === void 0 ? void 0 : _b.call(options, { errMsg: '用户取消扫码' });
+            }
+            else {
+                (_c = options.fail) === null || _c === void 0 ? void 0 : _c.call(options, { errMsg: ret.resp_message || '扫码失败' });
+            }
+            (_d = options.complete) === null || _d === void 0 ? void 0 : _d.call(options, ret);
+        });
+    };
+    // uni.chooseImage = chooseImage 会报错： Cannot assign to read only property 'chooseImage' of object '[object Object]'
+    UniProxy.chooseImage = (options) => {
+        const request = {
+            extension: options.extension || [], //TODO 未实现
+            sourceType: options.sourceType || ['album', 'camera'],
+            camera: 'back',
+            mediaType: ['image'],
+            count: options.count || 9,
+            maxDuration: 30, // 图片忽略
+            sizeType: ['original', 'compressed'] //TODO 未实现
+        };
+        JsBridgeHandlers.handleChooseMedia(request).then((ret) => {
+            var _a, _b, _c;
+            if (ret == null) {
+                (_a = options.fail) === null || _a === void 0 ? void 0 : _a.call(options, { errMsg: '用户取消' });
+            }
+            else {
+                const result = {
+                    tempFiles: ret.tempFiles.map((item) => {
+                        return {
+                            path: item.tempFilePath,
+                            size: item.size,
+                            type: item.fileType,
+                            name: item.name,
+                            width: item.width,
+                            height: item.height
+                        };
+                    }),
+                    tempFilePaths: ret.tempFilePaths
+                };
+                (_b = options.success) === null || _b === void 0 ? void 0 : _b.call(options, result);
+            }
+            (_c = options.complete) === null || _c === void 0 ? void 0 : _c.call(options, ret);
+        });
+    };
+    uni.chooseVideo = (options) => {
+        const request = {
+            extension: options.extension || [], //TODO 未实现
+            sourceType: options.sourceType || ['album', 'camera'],
+            camera: options.camera || 'back',
+            mediaType: ['video'],
+            count: 1,
+            maxDuration: options.maxDuration || 30, // 图片忽略
+            sizeType: ['original', 'compressed'] //TODO 未实现
+        };
+        JsBridgeHandlers.handleChooseMedia(request).then((ret) => {
+            var _a, _b, _c;
+            if (ret == null) {
+                (_a = options.fail) === null || _a === void 0 ? void 0 : _a.call(options, { errMsg: '用户取消' });
+            }
+            else {
+                const first = ret.tempFiles[0];
+                // eslint-disable-next-line @typescript-eslint/ban-ts-ignore
+                // @ts-ignore
+                const result = {
+                    tempFilePath: first.tempFilePath,
+                    size: first.size,
+                    duration: first.duration / 1000,
+                    height: first.height,
+                    width: first.width,
+                    name: first.name
+                };
+                (_b = options.success) === null || _b === void 0 ? void 0 : _b.call(options, result);
+            }
+            (_c = options.complete) === null || _c === void 0 ? void 0 : _c.call(options, ret);
+        });
+    };
+    uni.getImageInfo = (options) => {
+        const request = {
+            src: options.src
+        };
+        JsBridgeHandlers.handleGetImageInfo(request).then((ret) => {
+            var _a;
+            const result = {
+                width: ret.width,
+                height: ret.height,
+                path: ret.tempFilePath,
+                type: ret.fileType,
+                orientation: ''
+            };
+            (_a = options.success) === null || _a === void 0 ? void 0 : _a.call(options, result);
+        });
+    };
+    UniProxy.pathToBase64 = function (path) {
+        return new Promise((resolve, reject) => {
+            JsBridgeHandlers.handlePathToBase64({ src: path }).then((result) => {
+                if (result && result.startsWith('data:'))
+                    resolve(result);
+                else
+                    reject(result);
+            });
+        });
+    };
+    uni.uploadFile = (options) => {
+        // 核心修复：防止 DataCloneError
+        // iOS 的 postMessage 无法克隆包含 success/fail 等函数的对象
+        // 我们必须提取出纯数据字段发送给原生
+        const request = {
+            url: options.url,
+            filePath: options.filePath,
+            name: options.name,
+            formData: options.formData,
+            header: options.header,
+            timeout: options.timeout
+        };
+        JsBridgeHandlers.handleUploadFile(request).then((ret) => {
+            var _a, _b, _c;
+            if (ret.code === 200) {
+                (_a = options.success) === null || _a === void 0 ? void 0 : _a.call(options, {
+                    data: ret.data || '',
+                    statusCode: ret.statusCode || 200
+                });
+            }
+            else {
+                (_b = options.fail) === null || _b === void 0 ? void 0 : _b.call(options, { errMsg: ret.errMsg || '上传失败' });
+            }
+            (_c = options.complete) === null || _c === void 0 ? void 0 : _c.call(options, { errMsg: ret.errMsg || '' });
+        });
+        //TODO 假的，不支持
+        return {
+            abort: () => { },
+            onHeadersReceived: () => { },
+            offHeadersReceived: () => { },
+            onProgressUpdate: () => { },
+            offProgressUpdate: () => { }
+        };
+    };
+    // 这里不能直接赋值，后面uni-simple-router会重写uni.navigateBack，导致此处赋值失效，所以用setTimeout延时赋值就ok了
+    setTimeout(() => {
+        // 原始的navigateBack
+        const navigateBack = uni.navigateBack;
+        uni.navigateBack = (options) => {
+            const pages = getCurrentPages();
+            if (pages && pages.length > 1) {
+                navigateBack(options);
+            }
+            else {
+                JsBridgeHandlers.handleCloseWebView();
+            }
+        };
+    }, 100);
+    uni.makePhoneCall = (options) => {
+        const request = {
+            phoneNumber: options.phoneNumber
+        };
+        JsBridgeHandlers.handleMakePhoneCall(request).then((ret) => {
+            var _a, _b, _c;
+            if (ret)
+                (_a = options.fail) === null || _a === void 0 ? void 0 : _a.call(options, ret);
+            else
+                (_b = options.success) === null || _b === void 0 ? void 0 : _b.call(options, null);
+            (_c = options.complete) === null || _c === void 0 ? void 0 : _c.call(options, null);
+        });
+    };
+    uni.setNavigationBarTitle = (options) => {
+        const request = {
+            title: options.title
+        };
+        JsBridgeHandlers.handleSetNavigationBar(request).then((ret) => {
+            var _a, _b;
+            (_a = options.success) === null || _a === void 0 ? void 0 : _a.call(options, null);
+            (_b = options.complete) === null || _b === void 0 ? void 0 : _b.call(options, null);
+        });
+    };
+    uni.setNavigationBarColor = (options) => {
+        const request = {
+            frontColor: options.frontColor,
+            backgroundColor: options.backgroundColor
+        };
+        JsBridgeHandlers.handleSetNavigationBar(request).then((ret) => {
+            var _a, _b;
+            (_a = options.success) === null || _a === void 0 ? void 0 : _a.call(options, null);
+            (_b = options.complete) === null || _b === void 0 ? void 0 : _b.call(options, null);
+        });
+    };
+}
+
 /**
  * JSBridge SDK
  * 统一的原生能力封装
@@ -1645,5 +2088,5 @@ const Debug = {
     clearLogs: debug.clearLogs.bind(debug)
 };
 
-export { Debug, JSBridge, LogLevel, Monitor, getPlatform, inApp, init, isReady };
+export { Debug, JSBridge, JsBridgeHandlers, LogLevel, Monitor, UniProxy, getPlatform, hdH5Adapter, inApp, init, isReady };
 //# sourceMappingURL=index.esm.js.map