@zfqh/uniapp-x 0.0.0-stage → 0.0.2

package/lib/utils/navigate.js

@@ -0,0 +1,192 @@
+import { queryParams } from '@zfqh/uview-x/utils/function';
+import page from '../configs/page';
+import nav from '../configs/navigate';
+import app from '../configs/app';
+import { IS_WEBVIEW_ENV, WEBVIEW_ENV } from './consts';
+import { inPages, getPage } from './pages';
+import { joinPath } from './index';
+import { pinia } from '../stores/pinia';
+import { useLoginStore } from '../stores/login';
+// 检测协议路�?
+const checkProtocolMatch = (url) => url.match(/^([\w.]+):\//);
+// 转换绝对路径
+const getAbsoUrl = (url, current) => {
+    if (!url.startsWith('/') && !checkProtocolMatch(url)) {
+        url = joinPath(current, url);
+        if (!url.startsWith('/')) {
+            url = `/${url}`;
+        }
+    }
+    return url;
+};
+// 节流，防止重复执�?
+let throttling = false;
+const navigate = function (url = '', type = 'navigateTo') {
+    if (!throttling) {
+        throttling = true;
+        setTimeout(() => {
+            throttling = false;
+        }, 500);
+        let needLogin = false;
+        let isNative = !page.pages?.length;
+        let navigateOptions = {};
+        let webviewParams = {};
+        let webviewPage = getPage('webview');
+        let loginType = nav.loginType;
+        let referrerType = nav.referrerType;
+        let opts = {};
+        if (typeof url === 'string') {
+            url = { url };
+        }
+        if (typeof url === 'object') {
+            opts = url;
+            const { type: _type, url: _url = '', params: _params = {}, webviewParams: _webviewParams = {}, webviewUrl: _webviewPage = webviewPage, needLogin: _needLogin = needLogin, loginType: _loginType = loginType, referrerType: _referrerType = referrerType, native: _isNative = isNative, ...rest } = url;
+            url = `${_url}${queryParams(_params)}`;
+            needLogin = !!_needLogin;
+            isNative = !!_isNative;
+            loginType = _loginType;
+            referrerType = _referrerType;
+            type = _type || type;
+            webviewParams = _webviewParams;
+            webviewPage = _webviewPage;
+            navigateOptions = rest;
+        }
+        const indexPage = getPage('index').replace(/^\/+/, '');
+        const loginPage = getPage('login');
+        const { isLogin } = useLoginStore(pinia);
+        const { route = indexPage, options = {} } = (getCurrentPages().pop() || {});
+        const current = `/${route}${queryParams(options)}`;
+        let absoUrl = getAbsoUrl(url, current);
+        let originalUrl = url;
+        url = navigate.interceptor.call(this, url, absoUrl);
+        if (typeof url !== 'string') {
+            throttling = false;
+            return;
+        }
+        if (originalUrl !== url) {
+            originalUrl = url;
+            absoUrl = getAbsoUrl(url, current);
+        }
+        if (!originalUrl) {
+            if (isLogin) {
+                throttling = false;
+                return;
+            }
+            // 跳转地址为空表示需要登�?
+            needLogin = true;
+        }
+        // 路径转为绝对路径
+        url = absoUrl;
+        // 是否需要登�?
+        if (!needLogin) {
+            needLogin = inPages(page.needLoginPages, url);
+        }
+        // 是否是原生页�?
+        if (!isNative && url.startsWith('/')) {
+            isNative = inPages(page.nativePages, url);
+        }
+        if (!isNative) {
+            if (!checkProtocolMatch(url)) {
+                if (app?.code) {
+                    url = `${app.code}:/${url}`;
+                }
+                else if (app?.appId) {
+                    url = `${app.appId}:/${url}`;
+                }
+            }
+        }
+        else if (IS_WEBVIEW_ENV && opts['native'] === false) {
+            isNative = false;
+        }
+        const protocolMatch = checkProtocolMatch(url);
+        // 带协议路径需要转换为webview方式加载
+        if (protocolMatch) {
+            isNative = true;
+            const params = Object.assign({}, webviewParams);
+            if (/^https?:/.test(url)) {
+                // #ifdef H5
+                // 一些网站同源策略，无法iframe中打开
+                if ((WEBVIEW_ENV.h5 || !IS_WEBVIEW_ENV) && ['mp.weixin.qq.com'].includes(new URL(url).hostname)) {
+                    top.location.href = url;
+                    return false;
+                }
+                // #endif
+                // http协议
+                Object.assign(params, { url: encodeURIComponent(url) });
+            }
+            else {
+                // 自定义协�?
+                url = url.replace(new RegExp(`^(${protocolMatch[0]})`), '');
+                Object.assign(params, { url: encodeURIComponent(url), app: protocolMatch[1] });
+            }
+            url = `${webviewPage}${queryParams(params)}`;
+        }
+        if (needLogin) {
+            if (!isLogin) {
+                const opts = {
+                    url: loginPage,
+                };
+                if (referrerType === 'combine') {
+                    // 登录后会先跳转到来源页面，再跳转目标页面
+                    if (url !== current) {
+                        url = `/${route}${queryParams({ ...options, __navigate: encodeURIComponent(url) })}`;
+                    }
+                }
+                else if (referrerType === 'referrer') {
+                    // 登录后跳转到来源页面
+                    url = current;
+                }
+                else if (referrerType === 'target') {
+                    // 登录后跳转到目标页面
+                }
+                if (['target', 'referrer', 'combine'].includes(referrerType)) {
+                    opts.url += `${opts.url.includes('?') ? '&' : '?'}__referrer=${encodeURIComponent(url)}`;
+                }
+                if (uni.webView && IS_WEBVIEW_ENV) {
+                    uni.webView[loginType](opts);
+                }
+                else {
+                    uni[loginType](opts);
+                }
+                return false;
+            }
+        }
+        if (originalUrl) {
+            if (inPages(page.tabBarPages, url)) {
+                if (['navigateTo', 'redirectTo'].includes(type)) {
+                    type = 'switchTab';
+                }
+            }
+            if (isNative && uni.webView && IS_WEBVIEW_ENV) {
+                uni.webView[type]({
+                    url,
+                });
+            }
+            else {
+                uni[type]({
+                    url,
+                    ...navigateOptions,
+                });
+            }
+        }
+    }
+};
+navigate.reLaunch = (url) => {
+    navigate(url, 'reLaunch');
+};
+navigate.navigateTo = (url) => {
+    navigate(url, 'navigateTo');
+};
+navigate.switchTab = (url) => {
+    navigate(url, 'switchTab');
+};
+navigate.redirectTo = (url) => {
+    navigate(url, 'redirectTo');
+};
+navigate.back = (e) => {
+    uni.navigateBack(e);
+};
+navigate.interceptor = (...args) => {
+    return args[0];
+};
+export default navigate;

package/lib/utils/pages.d.ts

@@ -0,0 +1,21 @@
+export declare const getPage: (name: string) => string;
+export declare const inPages: (pages: string[], url: string | {
+    url: string;
+    [key: string]: any;
+}) => boolean;
+export declare const createPages: (original?: {
+    pages?: any[];
+    subPackages?: any[];
+    tabBar?: any;
+    global?: {
+        native?: boolean;
+        needLogin?: boolean;
+        notRedirect?: boolean;
+    };
+}, basePath?: string) => {
+    pages: string[];
+    tabBarPages: string[];
+    nativePages: string[];
+    needLoginPages: string[];
+    notRedirectPages: string[];
+};

package/lib/utils/pages.js

@@ -0,0 +1,83 @@
+import path from '../configs/path';
+export const getPage = (name) => {
+    let page = '';
+    if (path[name]) {
+        page = path[name];
+    }
+    return page;
+};
+export const inPages = (pages, url) => {
+    if (typeof url === 'object') {
+        url = url.url;
+    }
+    if (!Array.isArray(pages) || !url || typeof url !== 'string') {
+        return false;
+    }
+    return pages.some((page) => {
+        page = String(page);
+        const [path] = page.split('**');
+        if (path !== page) {
+            return url.startsWith(path);
+        }
+        return url.replace(/\?.*$/, '') === path;
+    });
+};
+export const createPages = (original = {}, basePath = '') => {
+    const pages = [];
+    const tabBarPages = [];
+    const nativePages = [];
+    const needLoginPages = [];
+    const notRedirectPages = [];
+    const create = ({ path: p, root, ...rest }) => {
+        if (p) {
+            const { native, needLogin, notRedirect } = { ...original.global, ...rest };
+            const { name } = rest;
+            const array = [''];
+            if (basePath) {
+                array.push(basePath);
+            }
+            if (root && basePath !== `/${root}`) {
+                array.push(root);
+            }
+            array.push(p);
+            const page = array.join('/').replace(/\/+/, '/');
+            pages.push(page);
+            if (name) {
+                path[name] = page;
+            }
+            if (native || native == null) {
+                nativePages.push(page);
+            }
+            if (needLogin) {
+                needLoginPages.push(page);
+            }
+            if (notRedirect) {
+                notRedirectPages.push(page);
+            }
+        }
+    };
+    if (original.pages) {
+        original.pages.forEach((page) => {
+            create(page);
+        });
+    }
+    if (original.subPackages) {
+        original.subPackages.forEach(({ root, pages: list }) => {
+            list.forEach((page) => {
+                create(Object.assign(page, { root }));
+            });
+        });
+    }
+    if (original.tabBar && original.tabBar.list) {
+        original.tabBar.list.forEach(({ pagePath }) => {
+            tabBarPages.push(`/${pagePath}`);
+        });
+    }
+    return {
+        pages,
+        tabBarPages,
+        nativePages,
+        needLoginPages,
+        notRedirectPages,
+    };
+};

package/lib/utils/permission.d.ts

@@ -0,0 +1,17 @@
+type PermissionName = 'location' | 'storage' | 'camera' | 'record' | 'bluetooth';
+/**
+ * 打开权限设置
+ * - 经典 App：plus 打开系统设置页（定位 / 蓝牙总开关）
+ * - uni-app x App：uni.openAppAuthorizeSetting 打开应用授权设置页
+ * - H5 webview：向宿主发送消息
+ * - 小程序：uni.openAppAuthorizeSetting
+ */
+export declare function openAuthorizeSetting(name: string): void;
+/**
+ * 申请权限
+ * @param name 权限名称
+ * @param system 是否同时检查定位 / 蓝牙的系统级开关
+ * @returns 允许时 resolve(1)；未授权或系统开关关闭时 reject(0)
+ */
+export declare function requestPermission(name: PermissionName, system?: boolean): Promise<number>;
+export {};

package/lib/utils/permission.js

@@ -0,0 +1,278 @@
+/**
+ * 权限申请
+ * - 经典 App（APP-PLUS）：plus.android.requestPermissions（Android）+ uni.getSystemSetting
+ * - uni-app x App（APP + UNI-APP-X）：uni.requestSystemPermission（Android 5.25+）+ uni.getSystemSetting
+ * - 小程序：uni.authorize / uni.openSetting
+ * - H5：webview 内通过 postMessage 通知宿主
+ */
+import { config } from '@zfqh/uview-x';
+import { SYSTEM_INFO, IS_WEBVIEW_ENV, TYPES } from './consts';
+import { postMessage } from './index';
+const permissionData = {
+    location: {
+        // #ifdef APP
+        system: '检测到系统未开启定位',
+        // #endif
+        content: '我们需要获取您的定位权限，用于城市定位、地址获取、位置获取，发现附近设备等服务',
+    },
+    storage: {
+        // #ifdef APP
+        system: '',
+        // #endif
+        content: '我们需要获取您的文件存储权限，用于设置头像、保存图片、上传文件、发布内容等服务',
+    },
+    camera: {
+        // #ifdef APP
+        system: '',
+        // #endif
+        content: '我们需要获取您的相机权限，用于拍摄照片、录制视频、视频通话、扫码识别、发布内容等服务',
+    },
+    record: {
+        // #ifdef APP
+        system: '',
+        // #endif
+        content: '我们需要获取您的麦克风权限，用于录制语音、语音通话，发布内容等服务',
+    },
+    bluetooth: {
+        // #ifdef APP
+        system: '检测到系统未开启蓝牙',
+        // #endif
+        content: '我们需要获取您的蓝牙权限，用于数据传输、设备配对、发现附近设备等服务',
+    },
+};
+// #ifdef APP
+// Android 系统 API 版本：蓝牙、存储在 Android 10 / 12 以上需要的权限不同
+const ANDROID_API_LEVEL = Number(uni.getSystemInfoSync().osAndroidAPILevel) || 0;
+// #ifdef APP-PLUS
+const CLASSIC_ANDROID_PERMISSIONS = {
+    location: ['android.permission.ACCESS_FINE_LOCATION'],
+    storage: ['android.permission.WRITE_EXTERNAL_STORAGE'],
+    camera: ['android.permission.CAMERA'],
+    record: ['android.permission.RECORD_AUDIO'],
+    bluetooth: ANDROID_API_LEVEL >= 31
+        ? ['android.permission.BLUETOOTH_SCAN', 'android.permission.BLUETOOTH_CONNECT']
+        : ['android.permission.BLUETOOTH'],
+};
+// #endif
+// #ifdef UNI-APP-X
+const UNI_APP_X_ANDROID_PERMISSIONS = {
+    location: ['android.permission.ACCESS_FINE_LOCATION', 'android.permission.ACCESS_COARSE_LOCATION'],
+    // Android 10+ 使用分区存储，无需申请 WRITE_EXTERNAL_STORAGE
+    storage: ANDROID_API_LEVEL < 29 ? ['android.permission.WRITE_EXTERNAL_STORAGE'] : [],
+    camera: ['android.permission.CAMERA'],
+    record: ['android.permission.RECORD_AUDIO'],
+    bluetooth: ANDROID_API_LEVEL >= 31
+        ? ['android.permission.BLUETOOTH_SCAN', 'android.permission.BLUETOOTH_CONNECT']
+        : ['android.permission.BLUETOOTH'],
+};
+// #endif
+// #endif
+// #ifdef APP-PLUS
+const requestAndroidPermission = async (name) => {
+    const permissions = CLASSIC_ANDROID_PERMISSIONS[name];
+    if (!permissions.length) {
+        return 1;
+    }
+    uni.showAppFromBackground = false;
+    return await new Promise((resolve) => {
+        plus.android.requestPermissions(permissions, (result) => {
+            if (result.deniedAlways?.length) {
+                resolve(-1);
+            }
+            else if (result.deniedPresent?.length) {
+                resolve(0);
+            }
+            else {
+                resolve(1);
+            }
+        }, 
+        // 申请失败时无法预判，交给实际能力调用时系统弹窗
+        () => resolve(1));
+    });
+};
+// #endif
+// #ifdef APP
+// #ifdef UNI-APP-X
+const requestUniAppXPermission = async (name) => {
+    // #ifdef APP-ANDROID
+    if (typeof uni.requestSystemPermission === 'function') {
+        const permissions = UNI_APP_X_ANDROID_PERMISSIONS[name];
+        if (permissions.length) {
+            uni.showAppFromBackground = false;
+            return await new Promise((resolve) => {
+                uni.requestSystemPermission({
+                    permissions,
+                    success: (result) => {
+                        if (result.doNotAskAgainList.length) {
+                            resolve(-1);
+                        }
+                        else if (result.deniedList.length) {
+                            resolve(0);
+                        }
+                        else {
+                            resolve(1);
+                        }
+                    },
+                    // 无法预申请（低版本、权限未声明等）时交给实际能力调用时系统弹窗
+                    fail: () => resolve(1),
+                });
+            });
+        }
+    }
+    // #endif
+    return 1;
+};
+// #endif
+// #endif
+// #ifdef MP
+const requestMpPermission = async (scope) => {
+    return await new Promise((res) => {
+        uni.authorize({
+            scope,
+            success() {
+                res(1);
+            },
+            fail() {
+                res(0);
+            },
+        });
+    });
+};
+// #endif
+// 系统级开关：经典 App 与 uni-app x App 统一使用官方 uni.getSystemSetting
+const isSystemEnabled = (name) => {
+    // #ifdef APP
+    const setting = uni.getSystemSetting();
+    if (name === 'location') {
+        // iOS 模块未配置时 locationError 非空，不阻塞业务
+        return !!setting.locationError || setting.locationEnabled;
+    }
+    if (name === 'bluetooth') {
+        // iOS 与经典 App 保持一致交给系统；Android 权限或模块配置错误不误导用户去设置
+        return SYSTEM_INFO.platform === 'ios' || !!setting.bluetoothError || setting.bluetoothEnabled !== false;
+    }
+    // #endif
+    return true;
+};
+/**
+ * 打开权限设置
+ * - 经典 App：plus 打开系统设置页（定位 / 蓝牙总开关）
+ * - uni-app x App：uni.openAppAuthorizeSetting 打开应用授权设置页
+ * - H5 webview：向宿主发送消息
+ * - 小程序：uni.openAppAuthorizeSetting
+ */
+export function openAuthorizeSetting(name) {
+    // #ifdef H5
+    if (IS_WEBVIEW_ENV) {
+        postMessage({
+            type: name === 'location' ? TYPES.MESSAGE.PERM_LOCATION : TYPES.MESSAGE.PERM_BLUETOOTH,
+            payload: { name },
+        });
+    }
+    // #endif
+    // #ifdef APP-PLUS
+    if (SYSTEM_INFO.platform == 'ios') {
+        plus.runtime.openURL('app-settings://');
+    }
+    else {
+        const main = plus.android.runtimeMainActivity();
+        const Intent = plus.android.importClass('android.content.Intent');
+        const Settings = plus.android.importClass('android.provider.Settings');
+        let intent = null;
+        if (name === 'location') {
+            intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
+        }
+        else if (name === 'bluetooth') {
+            intent = new Intent(Settings.ACTION_BLUETOOTH_SETTINGS);
+        }
+        if (intent) {
+            main.startActivity(intent);
+        }
+    }
+    // #endif
+    // #ifdef APP
+    // #ifdef UNI-APP-X
+    if (typeof uni.openAppAuthorizeSetting === 'function') {
+        uni.openAppAuthorizeSetting({});
+    }
+    // #endif
+    // #endif
+    // #ifdef MP
+    uni.openAppAuthorizeSetting();
+    // #endif
+}
+/**
+ * 申请权限
+ * @param name 权限名称
+ * @param system 是否同时检查定位 / 蓝牙的系统级开关
+ * @returns 允许时 resolve(1)；未授权或系统开关关闭时 reject(0)
+ */
+export async function requestPermission(name, system = true) {
+    let result = 1;
+    // #ifdef MP
+    switch (name) {
+        case 'location': {
+            result = await requestMpPermission('scope.userLocation');
+            break;
+        }
+        case 'storage': {
+            break;
+        }
+        default: {
+            result = await requestMpPermission(`scope.${name}`);
+        }
+    }
+    // #endif
+    // #ifdef APP-PLUS
+    if (SYSTEM_INFO.platform === 'android') {
+        result = await requestAndroidPermission(name);
+    }
+    // #endif
+    // #ifdef APP
+    // #ifdef UNI-APP-X
+    result = await requestUniAppXPermission(name);
+    // #endif
+    // #endif
+    if (system && result > 0 && !isSystemEnabled(name)) {
+        result = -2;
+    }
+    if (result <= 0) {
+        const { content, system: systemTips } = permissionData[name];
+        uni.showModal({
+            title: '提示',
+            content: `${result === -2 ? systemTips : `${content}，检测到应用未开启权限`}，是否开启？`,
+            confirmText: '去开启',
+            cancelText: '取消',
+            confirmColor: config.color.primary,
+            cancelColor: config.color.tipsColor,
+            success: (res) => {
+                if (res.confirm) {
+                    try {
+                        // #ifdef MP
+                        uni.openSetting();
+                        // #endif
+                        // #ifdef APP-PLUS
+                        uni.showAppFromBackground = false;
+                        // app开启权限，系统没有开启
+                        if (result === -2) {
+                            openAuthorizeSetting(name);
+                            // 系统开启权限，app没有开启
+                        }
+                        else {
+                            uni.openAppAuthorizeSetting();
+                        }
+                        // #endif
+                        // #ifdef APP
+                        // #ifdef UNI-APP-X
+                        openAuthorizeSetting(name);
+                        // #endif
+                        // #endif
+                    }
+                    catch (e) { }
+                }
+            },
+        });
+        return Promise.reject(0);
+    }
+    return Promise.resolve(1);
+}

package/lib/utils/query.d.ts

@@ -0,0 +1,20 @@
+interface Query {
+    platform?: string;
+    channel?: string;
+    token?: string;
+    accessToken?: string;
+    primary?: string;
+    app?: string;
+    safeTop?: string | number;
+    safeBottom?: string | number;
+    tabbar?: string | number;
+    accelerate?: string | number;
+    [key: string]: any;
+}
+declare const query: Query;
+export declare function parseQuery(search?: string): Query;
+/** 将对象序列化为 query string（供 webview 参数拼装使用，避免依赖 qs）。 */
+export declare function stringifyQuery(data: Record<string, any>, options?: {
+    encode?: boolean;
+}): string;
+export default query;

package/lib/utils/query.js

@@ -0,0 +1,51 @@
+const query = {};
+export function parseQuery(search = '') {
+    const q = {};
+    search.split('&').forEach((value) => {
+        if (!value)
+            return;
+        const [key, val] = value.split('=');
+        q[key] = decodeURIComponent(val);
+    });
+    return q;
+}
+/** 将对象序列化为 query string（供 webview 参数拼装使用，避免依赖 qs）。 */
+export function stringifyQuery(data, options = {}) {
+    const shouldEncode = options.encode !== false;
+    const parts = [];
+    const append = (key, value) => {
+        if (value === undefined || value === null)
+            return;
+        const k = shouldEncode ? encodeURIComponent(key) : key;
+        const v = shouldEncode ? encodeURIComponent(String(value)) : String(value);
+        parts.push(`${k}=${v}`);
+    };
+    Object.keys(data || {}).forEach((key) => {
+        const value = data[key];
+        if (Array.isArray(value)) {
+            value.forEach((item) => append(key, item));
+        }
+        else {
+            append(key, value);
+        }
+    });
+    return parts.join('&');
+}
+// #ifdef H5
+Object.assign(query, parseQuery(location.search.substring(1)));
+const safeTop = Number(query.safeTop);
+const safeBottom = Number(query.safeBottom);
+if (safeTop > 0) {
+    query.safeTop = safeTop;
+}
+else {
+    query.safeTop = 0;
+}
+if (safeBottom > 0) {
+    query.safeBottom = safeBottom;
+}
+else {
+    query.safeBottom = 0;
+}
+// #endif
+export default query;

package/lib/utils/request.d.ts

@@ -0,0 +1,8 @@
+export declare function formatURL(url: any, data: any): string;
+export declare function createInterceptors(req: any): void;
+export declare function createRequest(req: any, _opts?: any): {
+    GET: (url: string, data?: {}, options?: {}) => any;
+    DELETE: (url: string, data?: {}, options?: {}) => any;
+    POST: (url: string, data?: {}, options?: {}) => any;
+    PUT: (url: string, data?: {}, options?: {}) => any;
+};