tmui-cli 2.0.1 → 2.0.3

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xScreenshotS /346/210/252/345/233/276/344/270/216/351/230/262/346/210/252/345/261/217.md"

@@ -0,0 +1,177 @@
+# x-screenshot-s 截图与防截屏
+
+窗口截图、节点截图、系统截屏监测并回传当前页截图、防截屏 / 录屏检测。函数与类型均加 `x` 前缀，避免与官方同名冲突。一次性 API 使用 DCloud `success / fail / complete`。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 窗口支持，节点截图不建议 | 支持 | 支持 | 节点截图部分支持 | 监测 / 防截屏部分支持 |
+
+Web 端窗口截图、防截屏返回 `fail 1005 / 1008`。微信端主动截图返回 `fail 1005`，`xOnUserCaptureScreen` 可监听但不回传图片。鸿蒙节点截图见注意事项。
+
+### 调用
+
+```ts
+import {
+  xTakeSnapshot,
+  xTakeElementSnapshot,
+  xOnUserCaptureScreen,
+  xOffUserCaptureScreen,
+  xSetUserCaptureScreen,
+  xGetUserCaptureScreen,
+  xOnScreenCapturedChange,
+  xOffScreenCapturedChange,
+  xIsScreenCaptured,
+  xIsCaptureScreenEnabled,
+  XTakeSnapshotOptions,
+  XTakeElementSnapshotOptions
+} from "@/uni_modules/x-screenshot-s"
+
+xTakeSnapshot({
+  format: "png",
+  success: (res) => {
+    console.log(res.path, res.width, res.height)
+  }
+} as XTakeSnapshotOptions)
+
+const ele = uni.getElementById("shotBox")
+xTakeElementSnapshot({
+  ele: ele,
+  format: "png",
+  success: (res) => {
+    uni.previewImage({
+      current: res.path,
+      urls: [res.path] as string[]
+    })
+  }
+} as XTakeElementSnapshotOptions)
+
+const listenId = xOnUserCaptureScreen((res) => {
+  // res.path 为监测到系统截屏后，插件即时截取的当前窗口图，便于反馈上传
+  console.log(res.path, res.systemPath)
+})
+
+xSetUserCaptureScreen({
+  enable: false
+})
+
+const recordId = xOnScreenCapturedChange((res) => {
+  console.log(res.captured)
+})
+
+xOffUserCaptureScreen(listenId)
+xOffScreenCapturedChange(recordId)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xTakeSnapshot | 截取当前窗口 |
+| xTakeElementSnapshot | 截取指定节点 |
+| xOnUserCaptureScreen | 监听用户系统截屏，返回监听 id；回调带当前窗口即时截图路径 |
+| xOffUserCaptureScreen | 移除截屏监听；不传 id 则移除本插件全部截屏监听 |
+| xSetUserCaptureScreen | `enable: true` 允许截屏，`false` 禁止截屏 / 录屏 |
+| xGetUserCaptureScreen | 查询当前是否允许系统截屏 |
+| xOnScreenCapturedChange | 监听录屏 / 投屏 / 镜像变化，返回监听 id |
+| xOffScreenCapturedChange | 移除录屏监听；不传 id 则全部移除 |
+| xIsScreenCaptured | 同步查询是否正在被录屏 / 投屏 |
+| xIsCaptureScreenEnabled | 同步查询是否允许系统截屏 |
+
+旧 API `getRootShotImage` / `getElementShotImage` 已移除，请改用 `xTakeSnapshot` / `xTakeElementSnapshot`。
+
+### 参数
+
+`format`：`png`（默认）或 `jpg`。节点 PNG 仅绘制目标 View，并临时去掉目标自身 background 以保留透明底；JPG 会合成父级背景。
+
+`quality`：仅 JPG，范围 1-100，默认 90。
+
+`xSetUserCaptureScreen.enable`：`true` 允许用户截屏，`false` 开启隐私保护。插件主动截图在 Android / iOS 上仍可用，方便应用内反馈。
+
+### 错误码
+
+`1001` 截图失败，`1002` 未知错误，`1003` 元素无效，`1004` 宽高为 0，`1005` 当前平台不支持截图，`1006` 系统版本过低，`1007` format 非法，`1008` 当前平台不支持该能力，`1009` 参数错误，`1010` 防截屏设置失败，`1011` 权限被拒绝。
+
+### 平台差异
+
+**Android**
+
+- 窗口截图：Android 7.0+ 优先 `PixelCopy`，失败或已防截屏时回退 Canvas，并叠加 TextureView 画面。
+- 系统截屏监测：Android 14+ 使用 `registerScreenCaptureCallback`（需 `DETECT_SCREEN_CAPTURE`）。更低版本用 MediaStore / 截屏目录监听，建议授予 `READ_MEDIA_IMAGES` 或 `READ_EXTERNAL_STORAGE`。
+- 防截屏：`FLAG_SECURE`。
+- 录屏检测：Android 15+ `addScreenRecordingCallback`。
+
+**iOS**
+
+- 截图：`drawHierarchy(afterScreenUpdates: true)`。
+- 系统截屏监测：`userDidTakeScreenshotNotification`，系统不提供原图，插件会即时截取当前页。
+- 防截屏：iOS 13+ 安全图层（iOS 15.1 不支持，`fail 1010`）。
+- 录屏 / 投屏：`UIScreen.isCaptured` + `capturedDidChangeNotification`。
+
+**HarmonyOS**
+
+- 窗口截图：`window.snapshot`。
+- 节点截图：鸿蒙不支持按节点查找，见下方注意事项。
+- 系统截屏监测：`window.on('screenshot')`，随后即时截取当前窗口。
+- 防截屏：`setWindowPrivacyMode`，需 `ohos.permission.PRIVACY_WINDOW`。
+- 录屏 / 投屏：`display.on('captureStatusChange')` / `display.isCaptured`。
+
+**Web**
+
+- 节点截图尽量转发元素 `takeSnapshot`。
+- 窗口截图、防截屏、系统截屏监测不可用。
+
+**微信小程序**
+
+- 监听转发 `wx.onUserCaptureScreen`，不回传图片。
+- 防截屏转发 `wx.setVisualEffectOnCapture`。
+- 主动截图不可用。
+
+### 注意事项
+
+使用前请打自定义基座。Android 无论本机系统都要打基座；iOS 在配好原生环境时可免打基座。修改 `config.json` / 权限后需重新打基座。
+
+大尺寸截图占用内存较高，反馈上传后可自行删除缓存文件。
+
+**鸿蒙 `xTakeElementSnapshot`（建议不使用）**：uni-app-x 鸿蒙不支持按节点查找（Vue `id` 落不到 ArkUI `.id()`）。插件会回退为窗口局部截图（按节点矩形裁剪 `window.snapshot`），不是真正的节点绘制。结果会带上叠在该区域上的其它内容，也不会去掉节点自身背景。需要节点截图请用 Android / iOS；鸿蒙请改用 `xTakeSnapshot` 截整窗。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 2.0.1（2026-08-20）
+* 修复鸿蒙节点截图 `1001`：不再用全局 `componentSnapshot.get`。改为当前页 `UIContext.getComponentSnapshot()`，找不到 ArkUI id 时按节点矩形裁剪 `window.snapshot`。
+
+### 2.0.0（2026-08-20）
+* **破坏性变更**：改为 DCloud 风格 `x` 前缀 API。`getRootShotImage` / `getElementShotImage` 分别更名为 `xTakeSnapshot` / `xTakeElementSnapshot`。
+* 新增系统截屏监测 `xOnUserCaptureScreen` / `xOffUserCaptureScreen`：检测到用户截屏后即时截取当前窗口并回传路径，方便反馈上传。
+* 新增防截屏 `xSetUserCaptureScreen` / `xGetUserCaptureScreen` / `xIsCaptureScreenEnabled`。
+* 新增录屏 / 投屏检测 `xOnScreenCapturedChange` / `xOffScreenCapturedChange` / `xIsScreenCaptured`。
+* 截图结果增加 `width` / `height`，JPG 支持 `quality`。
+* 鸿蒙去掉缺失的 HAR 依赖，改为 ETS 实现窗口 / 节点截图与隐私模式。
+* 对齐 Android / iOS / HarmonyOS / Web / 微信导出。
+
+### 1.0.5（2026-05-21）
+* 修复 Android 节点 PNG 透明背景被合成白底：png 仅绘制目标 View，不再使用 PixelCopy/根节点裁剪（jpg 仍保留屏幕合成以呈现父级背景）。
+* 进一步：PNG 节点截图绘制时临时清除目标节点自身 background（uni 容器常自带白底），绘制完即时恢复；子节点 background 不受影响。
+
+### 1.0.4（2026-05-21）
+* 修复 PNG 截图白底：iOS 设置 `opaque=false`（jpg 仍为不透明）；节点/窗口均使用 `drawHierarchy(in:bounds)`，避免 `window` 坐标截取导致黑图。
+* Android Canvas 回退路径从根 View 裁剪绘制，保留父级背景色。
+
+### 1.0.3（2026-05-21）
+* 新增 `format` 参数，支持 `png`、`jpg` 保存格式，**默认 png**。
+* 修复节点内含视频/TextureView 等组件时截图黑屏（Android）：优先 `PixelCopy` 窗口拷贝，失败时回退 Canvas 并叠加 TextureView 画面；iOS 保持 `drawHierarchy(afterScreenUpdates:true)` 以保障常规页面截图正常。
+* 新增错误码 `1007`：`format` 参数非法。
+
+### 1.0.2（2026-05-21）
+* **破坏性变更**：API 改为 uni 标准 opts 回调风格
+* 已使用的项目升级前请阅读 readme 示例，不可直接替换旧版回调写法。
+
+### 1.0.1（2025-07-27）
+* 兼容鸿蒙
+### 1.0.0（2024-12-18）
+* 对屏幕截图保存(不需要权限),对指定截图进行保存,安卓,ios支持,web不支持.

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xScreentgreyS /345/272/224/347/224/250/347/275/256/347/201/260.md"

@@ -0,0 +1,128 @@
+# x-screentgrey-s 应用置灰
+
+哀悼日等场景把界面置灰。标准 `-s` API 插件，对齐 DCloud `success / fail / complete`。
+
+整 App 与当前页是两套函数：
+
+- `setAppGrey` / `removeAppGrey`：作用在窗口根层，翻到其它页也保持灰色（微信除外）。
+- `setPageGrey` / `removePageGrey`：只灰当前页，其它页不受影响。
+
+旧写法 `setWindowGrey` / `removeWindowGrey` 已移除，请改用上面两套函数。
+
+### 兼容性
+
+| 能力 | Android | iOS | HarmonyOS | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- | --- |
+| 整 App 置灰 | 支持（Activity 根视图 ColorMatrix） | 支持（窗口饱和度叠加层，iOS 13+） | 支持（`setWindowGrayScale`） | 支持（`documentElement` filter） | 仅当前页，需传 `ele`，翻页不保持 |
+| 当前页置灰 | 支持（页面根 View） | 支持（当前页 UIView 叠加层） | 支持（节点 grayscale，否则当前页作用域窗口灰阶） | 支持（当前页 HTML 节点） | 支持，需传 `ele` |
+| amount 0–1 | 支持 | 不支持，大于 0 即全灰 | 支持 | 支持 | 支持 |
+
+Android / iOS 请打自定义基座。iOS 在 Mac 本机编译可不打包；Windows 开发 iOS 需要打包基座。
+
+### 调用
+
+```ts
+import {
+  setAppGrey,
+  removeAppGrey,
+  setPageGrey,
+  removePageGrey,
+  getScreenGreyState,
+  getScreenGreyCapabilities,
+  XScreenGreyOptions,
+  XScreenGreyFailInfo,
+  XScreenGreyResult
+} from "@/uni_modules/x-screentgrey-s"
+
+const caps = getScreenGreyCapabilities()
+
+setAppGrey({
+  success: (res : XScreenGreyResult) => {
+    console.log(res.appGrey)
+  },
+  fail: (err : XScreenGreyFailInfo) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XScreenGreyOptions)
+
+setPageGrey({
+  ele: pageRoot, // 微信必传；其它端可省略，自动取当前页根节点
+  amount: 1
+} as XScreenGreyOptions)
+
+removePageGrey({} as XScreenGreyOptions)
+removeAppGrey({} as XScreenGreyOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| setAppGrey | 整 App 置灰。建议在启动页或需要全站哀悼时调用一次 |
+| removeAppGrey | 取消整 App 置灰 |
+| setPageGrey | 仅当前页置灰 |
+| removePageGrey | 取消当前页置灰 |
+| getScreenGreyState | 查询当前开关状态 |
+| getScreenGreyCapabilities | 同步返回平台能力 |
+
+### 参数
+
+`XScreenGreyOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| ele | 目标节点。单页置灰可不传；微信整 App / 单页都建议传当前页根节点 | - |
+| amount | 灰度 0–1。iOS 只能全灰或关闭 | 1 |
+| success | 成功，带 `appGrey` / `pageGrey` | - |
+| fail | 失败 | - |
+| complete | 结束，成功带结果，失败为 null | - |
+
+错误码：`1001` 系统错误，`1002` 参数错误，`1003` 找不到目标节点，`1008` 当前平台不支持。
+
+### 平台差异
+
+**Android**
+
+- 整 App：对当前 Activity `decorView` 以及栈内每个页面的 `getAndroidView()` 做 `ColorMatrix.setSaturation(1 - amount)` + `LAYER_TYPE_HARDWARE`。新页面往往自带硬件层，不会继承窗口根滤镜，因此会拦截路由并在 Activity `onResume` 时重新套上。
+- 当前页：对 `UniPage.getAndroidView()` 或传入节点的原生 View 做同样处理；取消单页置灰时若整 App 仍开着，该页保持 App 灰色。
+- 取消时恢复 `LAYER_TYPE_NONE`。
+
+**iOS**（deploymentTarget 12，置灰需 iOS 13+）
+
+- 使用 `saturationBlendMode` 浅灰叠加层，不拦截触摸。
+- 整 App 加在 keyWindow 上，翻页仍盖住新页面。
+- 当前页加在当前页根 UIView 上。
+- `amount` 不生效，大于 0 即全灰。低于 iOS 13 返回 1008。
+
+**HarmonyOS**
+
+- 整 App：`Window.setWindowGrayScale(amount)`，窗口级，翻页保持。
+- 当前页：鸿蒙 ucss 不支持 CSS `filter`，写 `filter: grayscale()` 不会生效。实现上会尽量给页面节点加 ArkUI `grayscale`，并以当前页作用域的 `setWindowGrayScale` 保证看得见；跳转离开时恢复彩色，返回该页时再置灰。`redirectTo` / `reLaunch` 或返回后页面已销毁则清除单页状态。
+
+**Web**
+
+- 整 App：`document.documentElement` 的 CSS `filter`。
+- 当前页：当前页 HTML 根节点的 CSS `filter`。
+
+**微信小程序**
+
+- 没有窗口级滤镜。`setAppGrey` 与 `setPageGrey` 都作用在传入的 `ele` 上。
+- `appGreyPersist` 为 false：新开页面不会自动变灰，需要在该页再调一次。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.2（2026-08-20）
+* 修复 Android 整 App 置灰只作用于当前页：翻页后新页不再继承 `decorView` 硬件层滤镜。现会记住灰度并在每个页面 View、新 Activity 恢复时重新套上。
+### 1.1.1（2026-08-20）
+* 修复 HarmonyOS 当前页置灰无效：鸿蒙 ucss 不支持 CSS filter，改为节点 grayscale；找不到节点时用当前页作用域的窗口灰阶，跳转时恢复彩色。
+### 1.1.0（2026-08-20）
+* 改为 DCloud 风格 options + success/fail/complete，五端 API 对齐。
+* 拆成整 App 置灰 `setAppGrey` 与当前页置灰 `setPageGrey` 两套函数。
+* 补齐 HarmonyOS 窗口灰阶、Web / 微信滤镜，以及状态与能力查询。
+* 旧 API `setWindowGrey` / `removeWindowGrey` 已移除。
+### 1.0.0（2024-08-31）
+首次发布

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSendsmsS /345/217/221/351/200/201/347/237/255/344/277/241.md"

@@ -0,0 +1,84 @@
+# x-sendsms-s 发送短信
+
+拉起系统短信编辑界面，预填手机号和内容。参数与回调对齐微信 `wx.sendSms` 和 DCloud `success / fail / complete`。对外方法名为 `xSendSms`，类型统一加 `X` 前缀，避免和系统或微信同名冲突。
+
+成功只表示已经打开短信面板，不代表用户一定发送成功。不会在后台静默发短信。
+
+### 兼容性
+
+| Harmony | iOS | Android | WEB | 微信小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 移动端浏览器 | 支持 |
+
+### 调用
+
+```ts
+import { xSendSms, XSendSmsOptions } from "@/uni_modules/x-sendsms-s"
+
+xSendSms({
+  phoneNumber: "10086",
+  content: "查询话费",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+} as XSendSmsOptions)
+```
+
+多个号码用英文逗号分隔：
+
+```ts
+xSendSms({
+  phoneNumber: "10086,10010",
+  content: "你好"
+} as XSendSmsOptions)
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xSendSms | 拉起系统短信编辑界面 |
+
+### 参数
+
+`XSendSmsOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| phoneNumber | 预填手机号，多个用英文逗号分隔 | 空 |
+| content | 预填短信内容 | 空 |
+| success | 成功，`errMsg` 为 `xSendSms:ok` | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+`phoneNumber` 和 `content` 都可空，空值时打开空白短信面板。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误，或正在拉起短信界面 |
+| 1002 | 参数错误 |
+| 1003 | 当前设备不支持发送短信 |
+| 1008 | 当前平台不支持此功能 |
+
+### 平台差异
+
+1. 微信走官方 `wx.sendSms`，基础库 2.25.0+。
+2. Android 使用 `ACTION_SENDTO` + `smsto:`，不申请 `SEND_SMS`。
+3. iOS 使用系统 `MFMessageComposeViewController`，模拟器通常会返回 1003。
+4. HarmonyOS 通过 `sms:` 协议 `startAbility` 拉起系统短信应用。
+5. Web 仅在移动端浏览器用 `sms:` 链接；桌面端返回 1003。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.0.0（2026-08-16）
+
+- 新增 `xSendSms`，支持 Android / iOS / HarmonyOS / Web / 微信小程序拉起系统短信面板

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xShareS /347/263/273/347/273/237/345/210/206/344/272/253.md"

@@ -0,0 +1,134 @@
+# x-share-s 系统分享
+
+调用系统分享，把文本、链接、图片、音视频或任意文件发给其它应用。参数与回调对齐 DCloud `uni.shareWithSystem`，方法名使用 `xShare`，避免和 `uni.share` 重名。
+
+App 端不需要配置微信 / QQ 等三方 SDK。手机上能接收该类型内容的应用都会出现在列表里。
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 文本/链接 | 图片/视频/文件 |
+
+建议单次分享不要超过 30MB，部分机型会卡顿。
+
+### 调用
+
+```ts
+import { xShare } from "@/uni_modules/x-share-s"
+
+xShare({
+  summary: "欢迎使用 x-share-s",
+  success: (res) => {
+    console.log(res.errMsg)
+  },
+  fail: (err) => {
+    console.log(err.errCode, err.errMsg)
+  }
+})
+```
+
+未传 `type` 时按内容自动推断：有图片走 `image`，有 `path` 时按扩展名判断，否则为 `text`。
+
+```ts
+xShare({ summary: "一段文本" })
+xShare({ href: "https://uniapp.dcloud.net.cn" })
+xShare({ imageUrl: "/static/logo.png" })
+xShare({ path: tempFilePath })
+xShare({
+  type: "file",
+  filePaths: [pdfPath],
+  title: "分享文件"
+})
+```
+
+### 方法
+
+| 名称 | 说明 |
+| --- | --- |
+| xShare | 打开分享。App 成功表示已经调起系统面板，不代表用户一定分享成功 |
+
+### 参数
+
+`XShareOptions`
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| type | `text` / `image` / `video` / `audio` / `file`。不传则自动推断 | `text` |
+| title | Android 选择器标题；鸿蒙预览标题 | - |
+| summary | 文字内容 | - |
+| href | 链接，需 `http/https` | - |
+| imageUrl | 单张本地图片 | - |
+| imagePaths | 多张本地图片 | - |
+| videoPaths | 本地视频 | - |
+| audioPaths | 本地音频 | - |
+| filePaths | 本地文件 | - |
+| path | 单个本地路径快捷字段 | - |
+| success | 成功 | - |
+| fail | 失败 | - |
+| complete | 结束 | - |
+
+路径支持 `/static/...`、绝对路径、`file://`、Android `content://`。App 只支持本地文件。微信小程序可用本地/临时路径，网络图会先下载到临时文件。
+
+### 错误码
+
+| 码 | 含义 |
+| --- | --- |
+| 1001 | 系统错误 |
+| 1002 | 分享内容为空或 type 非法 |
+| 1003 | 图片路径无效 |
+| 1004 | 链接无效 |
+| 1005 | 视频路径无效 |
+| 1006 | 文件不存在 |
+| 1007 | 音频路径无效 |
+| 1008 | 当前平台不支持 |
+| 1009 | 用户取消 |
+
+### 平台差异
+
+1. Android 分享链接到微信只能以文本发出；同时带图片和链接时，微信通常只收图片。
+2. iOS 可以把链接作为独立项目分享；图片 + 链接时，部分应用会把图片当题图。选图/选文件返回的 tmp 绝对路径不要再走 `convert2AbsFullPath`（那是给 `/static` 用的），否则会报路径无效。
+3. Web 走 `navigator.share`，仅文本和链接。
+4. 微信小程序：图片用 `wx.showShareImageMenu`，视频用 `wx.shareVideoMessage`，文件/音频用 `wx.shareFileMessage`。一次只分享列表中的第一项，且必须是本地或临时路径（`wxfile://`、`http://tmp`、选图/截图返回值）。包内 `/static/...` 会先经 `wx.getImageInfo` 转成本地路径；网络图会先 `wx.downloadFile`。文本和链接请用页面 `onShareAppMessage`。
+5. App 的 `success` 表示系统分享面板已打开。Android / iOS / 鸿蒙无法可靠得知用户最终点了哪个应用。
+6. Android 已内置 FileProvider，一般不用再往工程根目录拷贝清单。
+7. 鸿蒙发起分享不需要在 `module.json5` 配 skills（那是接收分享用的）。选文件/相册拿到的 URI 只有临时权限，Share Kit 读不到，会提示「文本不存在」或「文件不支持分享」。插件会先拷到应用沙箱，再用 `fileUri.getUriFromPath` 转成 `file://<bundleName>/...`，并按后缀填精确 UTD。
+
+### 版本
+
+版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。
+
+## 更新日志
+
+### 1.1.5（2026-08-16）
+* iOS 增加 `info.plist` 语言配置（`zh-Hans` 开发语言 + Localizations），系统分享面板不再固定英文。
+### 1.1.4（2026-08-16）
+* iOS 选图后分享不再转 UIImage，并等相册 dismiss 完再 present，避免一直停在「分享中」。
+### 1.1.3（2026-08-16）
+* iOS 选图/选文件后再分享不再先 `convert2AbsFullPath`：临时绝对路径被当成包内相对路径后会报 1003/1006 路径无效。改为先按原路径/`file://` 检查存在，包内 `/static` 才回退转换。
+### 1.1.2（2026-08-16）
+* 鸿蒙分享文件先拷到沙箱再 `fileUri.getUriFromPath`，避免选文件临时 URI 被 Share Kit 报「文本不存在」
+### 1.1.1（2026-08-16）
+* 修复微信小程序分享图片报 `the type of property "src" is illegal`：只传原始字符串路径，先 `getImageInfo` 再 `showShareImageMenu`
+### 1.1.0（2026-08-16）
+* 重写为 DCloud 风格：`xShare({ type, summary, href, imageUrl, ... })`，带 success / fail / complete
+* 参数规范化，对齐 `uni.shareWithSystem`；可用 `path` 快捷分享单个文件，未传 type 时自动推断
+* 微信小程序支持图片（`wx.showShareImageMenu`）、视频（`wx.shareVideoMessage`）、文件（`wx.shareFileMessage`）
+* 鸿蒙改为系统 Share Kit；Android 内置 FileProvider
+### 1.0.8（2025-08-17）
+* 兼容原生鸿蒙
+### 1.0.6（2024-09-22）
+* 修改可能的文件无法读取的问题,有的用户把文件存在到非缓存目录.可能导致文件无法读取.
+### 1.0.5（2024-08-24）
+* 经过测试可以在uniapp上分享啦。也能在ios上分享，可以分享文本和链接到微信中，具体操作请购买后联系我。
+### 1.0.4（2024-08-06）
+* 安卓端改了下判断逻辑
+### 1.0.3（2024-08-05）
+* 解决uniapp项目无法在安卓上分享本地图片资源问题
+### 1.0.2（2024-07-30）
+IOS支持分享文件，视频，音频，图片到微信。
+### 1.0.1（2024-07-11）
+修改支持本地路径文件，兼容uniapp项目。
+### 1.0.0（2024-06-01）
+分享内容到其它应用
+安卓,ios支持。

package/data/tmui4x/10./346/217/222/344/273/266/345/272/223/xSkiaU Skia/347/224/273/345/270/203.md"

@@ -0,0 +1,115 @@
+# x-skia-u Skia画布
+
+实时 Canvas 2D 组件，以及离线单图 Recipe。两端共用同一套 Skia 内核。
+
+迁官方 canvas、合批、手势、鸿蒙/iOS 上屏等见 [常见问题.md](./常见问题.md)。
+
+离线 Recipe 与实时画布都从本插件导入：
+
+```ts
+import { XSkiaRecipe, getDominantColors, getRuntimeInfo } from "@/uni_modules/x-skia-u"
+import { XSkiaCanvas, XSkiaPath2D } from "@/uni_modules/x-skia-u"
+```
+
+### 兼容性
+
+| Harmony | IOS | Android | WEB | 小程序 |
+| --- | --- | --- | --- | --- |
+| 支持 | 支持 | 支持 | 支持 | 支持 |
+
+### 实时画布
+
+```vue
+<x-skia-u ref="canvasRef" :width="360" :height="360" background="#FFFFFF" @ready="drawFullScene"></x-skia-u>
+```
+
+```ts
+function drawFullScene() : void {
+  const canvas = canvasRef.value!.getContext("2d")
+  canvas!.fillStyle = "#2563eb"
+  canvas!.fillRect(20, 20, 80, 80)
+}
+
+canvasRef.value!.getContext("2d")!.toTempFilePath({
+  success: (res) => {
+    console.log(res.tempFilePath)
+  }
+})
+```
+
+### 离线 Recipe
+
+```ts
+const recipe = new XSkiaRecipe({ imagePath: srcPath })
+recipe.resize(720)
+recipe.filter("blur", { radius: 4 })
+recipe.export({
+  target: "file",
+  dst: outPath,
+  success: (res) => {
+    console.log(res.dst, recipe.offsetWidth, recipe.offsetHeight)
+  }
+})
+
+const colors = getDominantColors(srcPath, 5)
+```
+
+iOS 请用 `new XSkiaRecipe(...)`，不要用工厂函数返回的实例。
+
+### 参数
+
+| 字段 | 说明 | 默认 |
+| --- | --- | --- |
+| width | 宽度 | `320` |
+| height | 高度 | `240` |
+| background | 背景色，空为透明 | `""` |
+| pixelRatio | `≤0` 跟随屏幕 DPR | `0` |
+
+### 事件
+
+| 名称 | 参数 | 说明 |
+| --- | --- | --- |
+| ready | 无 | 画布已可呈现。之后缓冲因尺寸重建被清空时会再发，应在回调里全量重绘 |
+
+### 实时画布方法
+
+组件 ref：
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| getContext | `"2d"` | 返回 `XSkiaCanvas` |
+| createPath2D | 无 | 创建独立路径，跨端只传 `nativeHandle` |
+| destroy | 无 | 销毁画布 |
+
+`getContext("2d")` 上的绘制方法与原先一致：`fillRect` / `stroke` / `drawImage` / `toTempFilePath` 等。
+
+### 离线 Recipe 方法
+
+创建：
+
+| 名称 | 需要 | 说明 |
+| --- | --- | --- |
+| new XSkiaRecipe | `{ imagePath }` 或 `{ width, height, background? }` | 创建链式构造器。iOS 必须用 new |
+| xImage | `imagePath` | 从图片创建。iOS 请改用 `new XSkiaRecipe` |
+| xCanvas | `width`、`height`，可选 `background` | 空白画布 |
+
+链式方法（均返回 this，最后 `export`）：`resize` / `flip` / `rotate` / `rotate90` / `rotate180` / `rotate270` / `crop` / `roundClip` / `fillRect` / `strokeRect` / `line` / `circle` / `drawText` / `drawImage` / `filter` / `vignette` / `noise` / `gradient` / `export`。
+
+属性：`offsetWidth` / `offsetHeight`（创建后可用，export 成功后按实际输出刷新）。
+
+同步分析：`getImageInfo` / `getAverageColor` / `getDominantColors(path, count=5)` / `getPixelColor` / `getRuntimeInfo` / `getState`。
+
+Recipe 的整图叠加渐变类型是 `XSkiaOverlayGradient`（`from` / `to` / `colors`）。Canvas 2D 的 `XSkiaGradient` 是另一套（`x0` / `y0` / `stops`），不要混用。
+
+滤镜：`blur` / `brightness` / `contrast` / `grayscale` / `invert` / `opacity` / `saturate` / `sepia` / `hue-rotate` / `drop-shadow` / `sharpen` / `temperature` / `tint` / `blackpoint`。
+
+### 平台差异
+
+1. Path2D 跨边界只能传 `nativeHandle`。
+2. `toTempFilePath`、`registerFont`、画布渐变走 `getContext("2d")`。
+3. App 的 Recipe `dst` 为文件路径；Web 多为 dataURL；小程序为临时路径。后两者不要加 query。
+4. Recipe `target="view"` 会失败，请用实时画布。
+
+### 版本
+
+版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。