Update mini program development documentation and enhance user interface elements
- Added a new entry for the latest mini program development rules and APIs in the evolution index. - Updated the skill documentation to include guidelines on privacy authorization and capability detection. - Modified the read and settings pages to improve user experience with new input styles and layout adjustments. - Implemented user-select functionality for text elements in the read page to enhance interactivity. - Refined CSS styles for better responsiveness and visual consistency across various components.
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
# 联网吸收:微信小程序最新开发规则与 API(2025-03)
|
||||
|
||||
> 来源:微信开放文档、基础库更新日志、Skyline 文档、隐私合规指南等
|
||||
|
||||
---
|
||||
|
||||
## 一、基础库版本与更新节奏
|
||||
|
||||
- **当前最新**:v3.14.2(2026-01-22),v3.14.3 灰度中
|
||||
- **建议**:在 `app.json` 中设置 `"useExtendedLib": { "weui": true }` 或指定 `libVersion`,关注灰度版本说明
|
||||
- **兼容**:使用 `wx.canIUse('api.xxx')` 做能力检测,避免在低版本报错
|
||||
|
||||
---
|
||||
|
||||
## 二、新增 / 重要 API(基础库 3.14 系列)
|
||||
|
||||
| API | 用途 | 基础库 |
|
||||
|-----|------|--------|
|
||||
| `wx.rewriteRoute` | 路由重写 | 3.14+ |
|
||||
| `wx.openOfficialAccountProfile` | 打开公众号 | 3.14+ |
|
||||
| `wx.openOfficialAccountChat` | 跳转公众号会话 | 3.14+ |
|
||||
| `wx.openInquiriesTopic` | 跳转问一问话题 | 3.14.0 |
|
||||
| `wx.loadBuiltInFontFace` | 加载微信内置字体 | 3.14+ |
|
||||
| `wx.onUserOffTranslation` | 监听用户关闭翻译 | 3.14.3 灰度 |
|
||||
|
||||
**其他能力**:
|
||||
- 鼠标右键点击事件支持(PC 端)
|
||||
- 图片分享朋友圈
|
||||
- 半屏小程序 `openEmbeddedMiniProgram` 上限提升到 100
|
||||
- TCPSocket 支持 `TCP_NODELAY`
|
||||
|
||||
---
|
||||
|
||||
## 三、Skyline 渲染引擎(可选升级)
|
||||
|
||||
- **定位**:新一代渲染引擎,以性能为首要目标,仍用 WXML/WXSS
|
||||
- **配置**:页面级 `page.json` 中 `"renderer": "skyline"`
|
||||
- **性能**:启动耗时降约 20%,跳页耗时降约 50%;长列表 `scroll-view` 仅渲染屏内节点
|
||||
- **注意**:CSS 特性精简,只保留更现代的集合;鸿蒙 OS 已灰度支持
|
||||
- **Soul 项目**:当前为 WebView 渲染,若需性能优化可逐步按页面接入 Skyline
|
||||
|
||||
---
|
||||
|
||||
## 四、隐私合规(2025 重要变更)
|
||||
|
||||
### 4.1 核心变化:从集中授权改为按需授权
|
||||
|
||||
- **旧**:首次启动一次性请求所有权限
|
||||
- **新**:必须在用户**实际触发相关功能时**才发起对应授权请求
|
||||
- **影响**:需拆分授权逻辑到具体业务场景,不能集中在 `app.onLaunch` 里
|
||||
|
||||
### 4.2 必须完成的步骤
|
||||
|
||||
1. **后台配置**:在小程序管理后台填写《小程序用户隐私保护指引》,声明处理的用户信息类型及用途
|
||||
2. **查询与展示**:`wx.getPrivacySetting` 查询授权状态,`wx.openPrivacyContract` 打开隐私协议
|
||||
3. **获取同意**:使用 `<button open-type="agreePrivacyAuthorization">` 获取用户明示同意,用户点击后微信同步状态,开发者才可调用已声明的隐私接口
|
||||
|
||||
### 4.3 敏感权限
|
||||
|
||||
- 通讯录、位置、摄像头、麦克风、相册等**不会默认开启**
|
||||
- 需用户明确同意后才可调用
|
||||
- 需为「用户拒绝」设计降级方案
|
||||
|
||||
---
|
||||
|
||||
## 五、网络请求(wx.request)
|
||||
|
||||
- **官方**:`wx.request` 仍为主流,仅支持回调,不支持原生 Promise
|
||||
- **Soul 项目**:已用 `app.request` 封装,支持 Promise、统一 baseUrl、鉴权、错误处理,符合规范
|
||||
- **第三方**:若需更丰富能力(拦截器、重试等),可考虑 wechat-http、mini-quest 等
|
||||
|
||||
---
|
||||
|
||||
## 六、与 Soul 项目 SKILL 的衔接
|
||||
|
||||
| 联网吸收内容 | Soul miniprogram-dev SKILL 对应 |
|
||||
|-------------|--------------------------------|
|
||||
| 隐私按需授权 | 登录、手机号、推荐码等涉及隐私的接口,应在用户触发时再请求,避免启动时集中授权 |
|
||||
| Skyline 可选 | 当前 SKILL 未强制 Skyline;性能敏感页面可单独配置 `renderer: skyline` |
|
||||
| 新 API | 路由重写、公众号跳转等按需使用,调用前用 `wx.canIUse` 检测 |
|
||||
| 基础库版本 | 建议在项目文档中注明最低支持版本,便于兼容性排查 |
|
||||
|
||||
---
|
||||
|
||||
## 七、建议动作
|
||||
|
||||
1. **隐私合规**:检查 `app.js` 及登录/手机号/推荐码流程,确保按需授权,不在启动时集中请求
|
||||
2. **文档**:在 README 或开发文档中注明基础库最低版本(如 2.19.0 或 3.0.0)
|
||||
3. **能力检测**:新增依赖新 API 的功能时,使用 `wx.canIUse` 做降级
|
||||
4. **Skyline**:阅读页、章节列表等长列表页面可评估 Skyline 接入收益
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
| 日期 | 摘要 | 文件 |
|
||||
|------|------|------|
|
||||
| 2025-03-14 | 联网吸收:基础库 3.14、Skyline、隐私按需授权、新 API | [2025-03-14-联网吸收小程序最新开发规则与API.md](./2025-03-14-联网吸收小程序最新开发规则与API.md) |
|
||||
| 2026-02-28 | input 边距口诀、match 资源对接弹窗修正 | [2026-02-28.md](./2026-02-28.md) |
|
||||
| 2026-03-03 | 我的页面卡片区边距优化,16rpx 推荐值 | [2026-03-03.md](./2026-03-03.md) |
|
||||
| 2026-03-05 | 分支合并后核心流程自测;app.json 拆行;orders 接口确认 | [2026-03-05.md](./2026-03-05.md) |
|
||||
|
||||
Reference in New Issue
Block a user