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:
Alex-larget
2026-03-14 16:23:01 +08:00
parent 8778a42429
commit c936371165
27 changed files with 510 additions and 68 deletions

View File

@@ -0,0 +1,90 @@
# 联网吸收:微信小程序最新开发规则与 API2025-03
> 来源微信开放文档、基础库更新日志、Skyline 文档、隐私合规指南等
---
## 一、基础库版本与更新节奏
- **当前最新**v3.14.22026-01-22v3.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 接入收益

View File

@@ -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) |