更新记录

1.0.3(2024-09-12)

  • 【修复】修复已知BUG
  • 【优化】优化部分逻辑
  • 【新增】新增权限申请
  • 【更新】更新使用教程和文档

1.0.2(2024-09-09)

  • 【新增】新增SmartDialog,SmartToast系列
  • 【更新】更新文档使用教程
  • 【更新】调整源码授权价格和普通授权价格

1.0.1(2024-09-04)

  • 【新增】基础toast和dialog
  • 【优化】优化部分逻辑
  • 【更新】向下兼容4.23和4.24版本,4.26可能会产生问题
查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 4.24,Android:5.0,iOS:不支持,HarmonyNext:不确定 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

x-base-s【基础插件】

  • 文档未开放功能函数均在测试中,如想使用请直接看源代码

  • 完整示例demo地址:前往gitcode仓库

使用步骤

  • 1.导入你的uni-app x项目uni_module下
  • 2.引入以下基础使用示例代码,到你的代码里
  • 3.打包自定义基座(修改你的manifest.json的版本号和版本名称)
  • 如果你是试用,可以下载上面gitcode仓库代码,再进行以上1 2 3步骤
  • 普通授权/试用用户可能会出现引入找不到函数代码提示,这个目前是官方的BUG问题,但是不影响使用。

意见/BUG反馈指南

  • 进入uni-im群发出你的安卓型号,HBX版本,你的问题,你的截图
  • 你的需求功能,可以发布在插件评论区,仅限安卓不做IOS

基础使用示例

<script>
    import { 
        xShowToast,
        xShowDialog,
        X_DIALOG_RESULT_TYPE,
        X_DIALOG_TYPE
    } from "@/uni_modules/x-base-s"
    export default {
        methods: {
            showToast() {
                xShowToast("你好")
            },
            showDialog(){
                xShowDialog({title:"我是标题",content:"我是内容"} as X_DIALOG_TYPE,(result:X_DIALOG_RESULT_TYPE) => {
                    console.log(result)
                })
            }
        }
    }
</script>

方法列表

名称 参数 描述
xVibrator (time:number) 短震动,单位ms
xCreateNotification (options:X_NOTIFICATION_TYPE) 创建系统通知栏
xCallMobile (phoneNumber: string) 拨打电话
xEnableWifi (status:boolean) 开启/关闭WIFI
xInstallApp (options:X_INSTALL_TYPE) 下载文件(通知栏显示进度)
xShowToast (content: string) 系统轻提示弹窗
xShowDialog (options: X_DIALOG_TYPE, callback:(result:X_DIALOG_RESULT_TYPE) => void) 系统对话框弹窗
xShowSmartToast (options:X_SMART_TOAST_TYPE) SmartToast库的基础轻提示
xShowSmartEmotionToast (options:X_SMART_EMOTION_TOAST_TYPE) SmartToast库的类型轻提示
xShowSmartDialog (options:X_SMART_DIALOG_TYPE,callback:(result:X_SMART_DIALOG_RESULT)=>void) SmartDialog库的基础对话框
xShowSmartListDialog (options:X_SMART_DIALOG_TYPE,callback:(result:X_SMART_LIST_DIALOG_RESULT)=>void) SmartDialog库的列表对话框
xRequestPermission (permissions: string[],callback:(result:X_PERMISSIONS_RESULT) => void) 申请权限

xRequestPermission 方法使用说明

  • permissions参数是一个数组字符串的AndroidManifest.xml里的权限列表,你需要将对应的权限放进去,例如:["android.permission.ACCESS_NOTIFICATIONS"]
  • 如果控制台爆红就需要在你本地项目的根目录加入该权限

X_NOTIFICATION_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
channelID String - - 通知栏id,唯一标识
title String - - 通知栏标题
content String - - 通知栏内容
desc String - - 通知栏描述

X_INSTALL_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
downloadUrl String - - 下载地址
fileName String - - 文件名称

X_SMART_TOAST_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
position String top | center - 控制轻提示显示位置
content String - - 轻提示内容

X_SMART_EMOTION_TOAST_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
type String info | warning | success | error | fail success 轻提示的类型
content String - - 轻提示内容

X_SMART_DIALOG_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
title String - - 对话框标题
content String - - 对话框内容
cancelText String - 取消 取消文字内容
confirmText String - 确定 确定文字内容
delayToTime Number - - 是否开启倒计时确定按钮(设置时间则为开启,单位s)
cancelOnTouchOutside Boolean true false 设置是否可通过触碰周边区域取消dialog
cancelable Boolean false true 设置是否可通过BACK键取消
dimBehind Boolean false true 显示时周围背景是否变暗
confirmTextColor String - Blue 确认按钮文字颜色
confirmTextSize Number - Blue 确认按钮文字大小
confirmTextBold Boolean - Blue 确认按钮文字是否加粗

X_SMART_LIST_DIALOG_TYPE 参数配置

参数名 类型 可选值 默认值 是否必填 描述
items string[] - - 对话框列表数据
cancelable Boolean false | true - 是否可通过BACK键取消
cancelOnTouchOutside Boolean false | true - 是否可通过触碰周边区域取消dialog

X_SMART_DIALOG_RESULT 返回参数

参数名 类型 描述
confirm Boolean 确认
cancel Boolean 取消

X_SMART_LIST_DIALOG_RESULT 返回参数

参数名 类型 描述
index Number 当前选择的下标索引
name Number 当前选择的名称

X_PERMISSIONS_RESULT 返回参数

参数名 类型
code Number
msg String
X_PERMISSIONS_RESULT.code 返回值
描述
1 申请所有权限成功
0 申请部分权限成功
-1 拒绝了权限

X插件系列

x-base-s【基础插件】安卓好用的基础工具

x-sms【短信插件】为X系列插件打造完美轮子

x-tencent-u【腾讯地图】

x-tencent-s【腾讯定位】保活和持久,保姆和小白式的完美解决方案

x-gaode-s【高德定位】保姆和小白式完美解决方案

x-icon-u【图标组件】

x-short-video-u是一个高性能,高度配置的短视频组件

x-im-sdk 为即时通讯量身打造, 适配Android,iOS,Web

隐私、权限声明

1. 本插件需要申请的系统权限列表:

详细查看AndroidManifest.xml文件

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问