@umacloud/knowledge 1.0.1

package/mobile/02-playbooks/mobile-performance.md

@@ -0,0 +1,473 @@
+---
+title: 移动应用性能优化手册
+category: mobile/playbooks
+version: 1.0.0
+last_updated: 2026-03-20
+maintainer: Excellent（11964948@qq.com）
+knowledge_score: 9.0/10
+domain: mobile
+difficulty: intermediate
+quality_score: 70
+---
+
+# 开发：Excellent（11964948@qq.com）
+
+## 移动应用性能优化手册
+
+### 执行步骤
+
+#### 1. 性能基线建立
+- 定义关键指标：启动时间、FPS、内存占用、包体积。
+- 建立性能测试环境和监控工具。
+- 收集不同设备的性能数据作为基线。
+- 设置性能预算和告警阈值。
+
+#### 2. 性能瓶颈定位
+- 使用性能分析工具（Xcode Instruments、Android Profiler、Flipper）。
+- 分析启动流程、渲染性能、内存使用。
+- 定位网络请求、数据库查询、图片加载瓶颈。
+- 识别主线程阻塞和 ANR（Application Not Responding）。
+
+#### 3. 启动时间优化
+- 延迟加载非关键模块。
+- 优化初始化流程，避免同步阻塞。
+- 减少主线程任务，使用后台线程。
+- 预加载关键资源和数据。
+- 目标：冷启动 < 2 秒，热启动 < 0.5 秒。
+
+#### 4. UI 渲染优化
+- 保持 60 FPS，避免卡顿（每帧 < 16.67ms）。
+- 减少视图层级，避免过度绘制。
+- 使用虚拟列表渲染长列表。
+- 优化图片加载和缓存策略。
+- 避免在滚动时执行耗时操作。
+
+#### 5. 内存优化
+- 及时释放不再使用的资源。
+- 避免内存泄漏（监听器未取消、闭包引用）。
+- 优化图片内存占用（压缩、采样、复用）。
+- 使用对象池复用对象。
+- 监控内存峰值和 OOM 崩溃。
+
+#### 6. 网络优化
+- 减少 HTTP 请求次数（合并、批量）。
+- 启用 Gzip 压缩和 HTTPS。
+- 使用 CDN 加速静态资源。
+- 实施离线缓存策略（Cache-First、Network-First）。
+- 预加载和懒加载结合。
+
+#### 7. 包体积优化
+- 压缩图片资源（WebP、TinyPNG）。
+- 移除未使用的代码和资源。
+- 启用代码混淆和 Tree Shaking。
+- 按需加载功能模块。
+- 目标：Android APK < 50MB，iOS IPA < 100MB。
+
+#### 8. 数据库优化
+- 创建合适的索引加速查询。
+- 避免在大表上执行全表扫描。
+- 批量插入和更新操作。
+- 使用事务保证数据一致性。
+- 定期清理过期数据。
+
+#### 9. 电量优化
+- 减少后台任务和轮询。
+- 优化定位策略（精度、频率）。
+- 避免频繁的网络请求和唤醒。
+- 使用 JobScheduler 或 WorkManager 调度任务。
+- 监控电量消耗。
+
+#### 10. 持续监控与回归
+- 建立性能监控平台（Firebase Performance、Sentry）。
+- 设置性能门禁，失败自动阻断发布。
+- 定期性能回归测试。
+- 收集线上用户真实性能数据。
+
+### 常见优化策略
+
+#### React Native 优化
+```typescript
+/**
+ * 开发：Excellent（11964948@qq.com）
+ * 功能：优化 FlatList 性能
+ * 作用：通过配置优化参数提升长列表渲染性能
+ * 创建时间：2026-03-20
+ * 最后修改：2026-03-20
+ */
+
+import React, { useCallback, useMemo } from 'react';
+import { FlatList, View, Text, StyleSheet } from 'react-native';
+
+interface Item {
+  id: string;
+  title: string;
+}
+
+const OptimizedList: React.FC<{ items: Item[] }> = ({ items }) => {
+  // 使用 useCallback 避免重复创建函数
+  const renderItem = useCallback(
+    ({ item }: { item: Item }) => (
+      <View style={styles.item}>
+        <Text style={styles.title}>{item.title}</Text>
+      </View>
+    ),
+    []
+  );
+
+  // 使用 useMemo 缓存计算结果
+  const keyExtractor = useCallback(
+    (item: Item) => item.id,
+    []
+  );
+
+  // 使用 getItemLayout 提升性能（如果 item 高度固定）
+  const getItemLayout = useCallback(
+    (_: any, index: number) => ({
+      length: 60,
+      offset: 60 * index,
+      index,
+    }),
+    []
+  );
+
+  return (
+    <FlatList
+      data={items}
+      renderItem={renderItem}
+      keyExtractor={keyExtractor}
+      getItemLayout={getItemLayout}
+      // 性能优化参数
+      initialNumToRender={10}
+      maxToRenderPerBatch={10}
+      windowSize={5}
+      removeClippedSubviews={true}
+      updateCellsBatchingPeriod={50}
+      onEndReachedThreshold={0.5}
+    />
+  );
+};
+
+const styles = StyleSheet.create({
+  item: {
+    height: 60,
+    justifyContent: 'center',
+    paddingHorizontal: 16,
+    borderBottomWidth: 1,
+    borderBottomColor: '#e0e0e0',
+  },
+  title: {
+    fontSize: 16,
+  },
+});
+
+export default OptimizedList;
+```
+
+#### Flutter 优化
+```dart
+// 开发：Excellent（11964948@qq.com）
+// 功能：优化 ListView 性能
+// 作用：通过 const 和 builder 提升长列表渲染性能
+// 创建时间：2026-03-20
+// 最后修改：2026-03-20
+
+import 'package:flutter/material.dart';
+
+class Item {
+  final String id;
+  final String title;
+
+  const Item({required this.id, required this.title});
+}
+
+class OptimizedList extends StatelessWidget {
+  final List<Item> items;
+
+  const OptimizedList({Key? key, required this.items}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return ListView.builder(
+      itemCount: items.length,
+      // 使用 const 提升性能
+      itemBuilder: (context, index) {
+        final item = items[index];
+        return _ItemTile(item: item);
+      },
+      // 添加缓存扩展
+      cacheExtent: 1000,
+    );
+  }
+}
+
+// 提取为独立的 StatelessWidget 并使用 const 构造函数
+class _ItemTile extends StatelessWidget {
+  final Item item;
+
+  const _ItemTile({Key? key, required this.item}) : super(key: key);
+
+  @override
+  Widget build(BuildContext context) {
+    return Container(
+      height: 60,
+      padding: const EdgeInsets.symmetric(horizontal: 16),
+      alignment: Alignment.centerLeft,
+      decoration: const BoxDecoration(
+        border: Border(
+          bottom: BorderSide(color: Color(0xFFE0E0E0)),
+        ),
+      ),
+      child: Text(
+        item.title,
+        style: const TextStyle(fontSize: 16),
+      ),
+    );
+  }
+}
+```
+
+### 性能监控代码示例
+
+#### React Native 性能监控
+```typescript
+/**
+ * 开发：Excellent（11964948@qq.com）
+ * 功能：性能监控工具
+ * 作用：记录和上报关键性能指标
+ * 创建时间：2026-03-20
+ * 最后修改：2026-03-20
+ */
+
+import { Platform, NativeModules } from 'react-native';
+
+interface PerformanceMetric {
+  name: string;
+  duration: number;
+  timestamp: number;
+  metadata?: Record<string, any>;
+}
+
+class PerformanceMonitor {
+  private static instance: PerformanceMonitor;
+  private metrics: PerformanceMetric[] = [];
+
+  static getInstance(): PerformanceMonitor {
+    if (!PerformanceMonitor.instance) {
+      PerformanceMonitor.instance = new PerformanceMonitor();
+    }
+    return PerformanceMonitor.instance;
+  }
+
+  // 记录启动时间
+  markAppStart() {
+    const startTime = Date.now();
+    this.recordMetric('app_start', 0, { startTime });
+    return startTime;
+  }
+
+  // 记录启动完成
+  markAppReady(startTime: number) {
+    const duration = Date.now() - startTime;
+    this.recordMetric('app_ready', duration);
+    this.uploadMetrics();
+  }
+
+  // 记录屏幕渲染时间
+  markScreenRender(screenName: string, duration: number) {
+    this.recordMetric('screen_render', duration, { screenName });
+  }
+
+  // 记录 API 请求时间
+  markApiRequest(endpoint: string, duration: number, success: boolean) {
+    this.recordMetric('api_request', duration, {
+      endpoint,
+      success,
+    });
+  }
+
+  private recordMetric(
+    name: string,
+    duration: number,
+    metadata?: Record<string, any>
+  ) {
+    this.metrics.push({
+      name,
+      duration,
+      timestamp: Date.now(),
+      metadata,
+    });
+  }
+
+  // 上报性能数据
+  private async uploadMetrics() {
+    if (this.metrics.length === 0) return;
+
+    try {
+      // 上报到监控平台
+      await fetch('https://monitoring.example.com/api/performance', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          platform: Platform.OS,
+          version: Platform.Version,
+          metrics: this.metrics,
+        }),
+      });
+
+      this.metrics = [];
+    } catch (error) {
+      console.error('Failed to upload performance metrics:', error);
+    }
+  }
+}
+
+export const performanceMonitor = PerformanceMonitor.getInstance();
+```
+
+#### Flutter 性能监控
+```dart
+// 开发：Excellent（11964948@qq.com）
+// 功能：性能监控工具
+// 作用：记录和上报关键性能指标
+// 创建时间：2026-03-20
+// 最后修改：2026-03-20
+
+import 'dart:async';
+import 'dart:io';
+import 'package:flutter/foundation.dart';
+import 'package:dio/dio.dart';
+
+class PerformanceMetric {
+  final String name;
+  final int duration;
+  final int timestamp;
+  final Map<String, dynamic>? metadata;
+
+  PerformanceMetric({
+    required this.name,
+    required this.duration,
+    required this.timestamp,
+    this.metadata,
+  });
+
+  Map<String, dynamic> toJson() => {
+        'name': name,
+        'duration': duration,
+        'timestamp': timestamp,
+        'metadata': metadata,
+      };
+}
+
+class PerformanceMonitor {
+  static final PerformanceMonitor _instance = PerformanceMonitor._internal();
+  factory PerformanceMonitor() => _instance;
+  PerformanceMonitor._internal();
+
+  final List<PerformanceMetric> _metrics = [];
+  final Dio _dio = Dio();
+
+  // 记录启动时间
+  int markAppStart() {
+    final startTime = DateTime.now().millisecondsSinceEpoch;
+    _recordMetric('app_start', 0, {'startTime': startTime});
+    return startTime;
+  }
+
+  // 记录启动完成
+  void markAppReady(int startTime) {
+    final duration = DateTime.now().millisecondsSinceEpoch - startTime;
+    _recordMetric('app_ready', duration);
+    _uploadMetrics();
+  }
+
+  // 记录屏幕渲染时间
+  void markScreenRender(String screenName, int duration) {
+    _recordMetric('screen_render', duration, {'screenName': screenName});
+  }
+
+  // 记录 API 请求时间
+  void markApiRequest(String endpoint, int duration, bool success) {
+    _recordMetric('api_request', duration, {
+      'endpoint': endpoint,
+      'success': success,
+    });
+  }
+
+  void _recordMetric(
+    String name,
+    int duration, [
+    Map<String, dynamic>? metadata,
+  ]) {
+    _metrics.add(PerformanceMetric(
+      name: name,
+      duration: duration,
+      timestamp: DateTime.now().millisecondsSinceEpoch,
+      metadata: metadata,
+    ));
+  }
+
+  // 上报性能数据
+  Future<void> _uploadMetrics() async {
+    if (_metrics.isEmpty) return;
+
+    try {
+      await _dio.post(
+        'https://monitoring.example.com/api/performance',
+        data: {
+          'platform': Platform.operatingSystem,
+          'version': Platform.version,
+          'metrics': _metrics.map((m) => m.toJson()).toList(),
+        },
+      );
+      _metrics.clear();
+    } catch (e) {
+      debugPrint('Failed to upload performance metrics: $e');
+    }
+  }
+}
+
+final performanceMonitor = PerformanceMonitor();
+```
+
+### 性能优化检查清单
+
+#### 启动性能
+- [ ] 冷启动时间 < 2 秒
+- [ ] 热启动时间 < 0.5 秒
+- [ ] 延迟加载非关键模块
+- [ ] 优化初始化流程
+- [ ] 预加载关键数据
+
+#### UI 渲染性能
+- [ ] FPS 稳定在 60 帧
+- [ ] 避免过度绘制（Overdraw < 2x）
+- [ ] 使用虚拟列表渲染长列表
+- [ ] 优化图片加载策略
+- [ ] 避免在滚动时执行耗时操作
+
+#### 内存优化
+- [ ] 内存峰值 < 200MB
+- [ ] 无内存泄漏
+- [ ] 及时释放资源
+- [ ] 优化图片内存占用
+- [ ] 监控 OOM 崩溃率
+
+#### 网络性能
+- [ ] 首屏数据加载 < 1 秒
+- [ ] 启用 Gzip 压缩
+- [ ] 实施 CDN 加速
+- [ ] 离线缓存策略
+- [ ] 减少请求次数
+
+#### 包体积
+- [ ] Android APK < 50MB
+- [ ] iOS IPA < 100MB
+- [ ] 压缩图片资源
+- [ ] 移除未使用代码
+- [ ] 启用代码混淆
+
+### 参考资料
+- React Native 性能优化：https://reactnative.dev/docs/performance
+- Flutter 性能优化：https://flutter.dev/docs/performance/rendering
+- Android 性能优化：https://developer.android.com/topic/performance
+- iOS 性能优化：https://developer.apple.com/documentation/performance

package/mobile/03-checklists/mobile-release-checklist.md

@@ -0,0 +1,234 @@
+---
+title: 移动应用发布检查清单
+category: mobile/checklists
+version: 1.0.0
+last_updated: 2026-03-20
+maintainer: Excellent（11964948@qq.com）
+knowledge_score: 9.1/10
+domain: mobile
+difficulty: intermediate
+quality_score: 70
+---
+
+# 开发：Excellent（11964948@qq.com）
+
+## 移动应用发布检查清单
+
+### 一、功能完整性检查
+
+#### 核心功能验证
+- [ ] 所有核心功能流程端到端测试通过
+- [ ] 关键业务逻辑单元测试覆盖率 >= 80%
+- [ ] 集成测试覆盖主要场景
+- [ ] E2E 测试通过率 100%
+- [ ] 回归测试通过，无新增缺陷
+- [ ] 边界条件和异常场景测试完成
+
+#### 用户体验验证
+- [ ] 关键路径用户旅程测试完成
+- [ ] 交互响应时间符合预期（< 300ms）
+- [ ] 加载状态和空态展示正确
+- [ ] 错误提示友好且可操作
+- [ ] 表单验证逻辑完整
+- [ ] 深度链接功能正常
+
+### 二、性能与稳定性检查
+
+#### 性能指标
+- [ ] 冷启动时间 < 2 秒
+- [ ] 热启动时间 < 0.5 秒
+- [ ] FPS 稳定在 60 帧，无明显卡顿
+- [ ] 内存峰值 < 200MB
+- [ ] CPU 占用率 < 30%（正常使用）
+- [ ] 电池消耗测试通过
+
+#### 稳定性指标
+- [ ] 崩溃率 < 0.1%
+- [ ] ANR 率 < 0.05%（Android）
+- [ ] 无内存泄漏检测
+- [ ] 长时间运行稳定性测试通过（2 小时+）
+- [ ] 弱网环境测试通过
+- [ ] 断网重连机制验证
+
+### 三、兼容性测试
+
+#### 设备兼容性
+- [ ] 覆盖主流厂商设备测试（Top 20）
+- [ ] 不同屏幕尺寸适配（4.7" - 7"）
+- [ ] 不同分辨率适配（720p - 2K）
+- [ ] 刘海屏、挖孔屏适配
+- [ ] 横竖屏切换测试（如适用）
+- [ ] 平板适配测试（如适用）
+
+#### 系统兼容性
+- [ ] Android 8.0+（API 26+）兼容性测试
+- [ ] iOS 12.0+ 兼容性测试
+- [ ] 最新系统版本兼容性测试
+- [ ] 系统升级兼容性验证
+- [ ] 系统特性降级处理（如权限）
+
+### 四、安全与合规检查
+
+#### 安全检查
+- [ ] 敏感数据加密存储（Keychain/Keystore）
+- [ ] HTTPS 强制启用，证书校验严格
+- [ ] 无硬编码密钥和敏感信息
+- [ ] 代码混淆和加固完成
+- [ ] 反调试和反逆向措施
+- [ ] WebView 安全配置正确
+
+#### 隐私合规
+- [ ] 隐私政策和用户协议更新
+- [ ] 权限申请说明文案清晰
+- [ ] 用户授权流程符合规范
+- [ ] 数据收集和使用符合 GDPR/CCPA
+- [ ] 未成年人保护机制（如适用）
+- [ ] 用户数据导出和删除功能
+
+### 五、网络与数据检查
+
+#### 网络功能
+- [ ] HTTPS 证书有效且未过期
+- [ ] API 接口版本兼容性验证
+- [ ] 网络超时和重试机制正常
+- [ ] 离线模式功能正常（如适用）
+- [ ] 网络切换（WiFi/4G/5G）无异常
+- [ ] 代理和 VPN 环境测试
+
+#### 数据管理
+- [ ] 数据库迁移脚本测试通过
+- [ ] 数据备份和恢复功能正常
+- [ ] 缓存清理功能正常
+- [ ] 数据同步机制验证
+- [ ] 大数据量场景测试
+
+### 六、国际化与本地化
+
+#### 多语言支持
+- [ ] 主要语言翻译完成并验证
+- [ ] 文案长度适配（不同语言长度差异）
+- [ ] 日期、时间、货币格式本地化
+- [ ] 数字格式本地化
+- [ ] 单复数处理正确
+- [ ] RTL 语言支持（阿拉伯语、希伯来语）
+
+#### 地区适配
+- [ ] 时区处理正确
+- [ ] 地区特定功能适配（支付、地图）
+- [ ] 法律法规合规性检查
+- [ ] 文化禁忌审查
+
+### 七、应用商店准备
+
+#### Android（Google Play）
+- [ ] 应用签名密钥准备
+- [ ] AAB（Android App Bundle）构建
+- [ ] 应用图标和启动屏素材
+- [ ] 应用截图（不同尺寸）
+- [ ] 应用描述和更新日志
+- [ ] 内容分级问卷填写
+- [ ] 隐私政策链接提供
+- [ ] 目标受众和内容声明
+
+#### iOS（App Store）
+- [ ] 开发者和发布证书配置
+- [ ] Provisioning Profile 配置
+- [ ] IPA 构建和验证
+- [ ] App Store 素材准备（图标、截图）
+- [ ] 应用描述和关键词
+- [ ] 版本更新说明
+- [ ] 隐私政策和使用条款
+- [ ] App 审核信息填写
+
+#### 国内应用商店（如适用）
+- [ ] 软著证书准备
+- [ ] ICP 备案（如需）
+- [ ] 各商店账号和资质审核
+- [ ] 素材适配各商店要求
+- [ ] 首发和更新策略规划
+
+### 八、监控与运维准备
+
+#### 监控配置
+- [ ] 崩溃监控集成（Crashlytics/Sentry）
+- [ ] 性能监控配置（Firebase Performance）
+- [ ] 业务埋点和统计配置
+- [ ] 日志收集和上报机制
+- [ ] 告警规则配置
+
+#### 运维准备
+- [ ] 灰度发布策略制定
+- [ ] 回滚方案准备和演练
+- [ ] 热修复能力验证（如支持）
+- [ ] 应急响应流程明确
+- [ ] 值班人员安排确认
+- [ ] 用户反馈渠道就绪
+
+### 九、法律与合规文件
+
+#### 法律文件
+- [ ] 隐私政策更新并发布
+- [ ] 用户服务协议更新
+- [ ] 第三方库许可证声明
+- [ ] 商标和版权检查
+- [ ] 数据处理协议（DPA）签署（如需）
+
+#### 合规认证
+- [ ] GDPR 合规性检查（如面向欧洲）
+- [ ] CCPA 合规性检查（如面向加州）
+- [ ] COPPA 合规性检查（如涉及儿童）
+- [ ] 等保测评（如需）
+- [ ] 行业特定合规要求（金融、医疗等）
+
+### 十、发布前最终确认
+
+#### 内部验收
+- [ ] 产品团队验收通过
+- [ ] 设计团队 UI/UX 验收通过
+- [ ] 测试团队验收通过
+- [ ] 安全团队审计通过
+- [ ] 法务团队合规审查通过
+
+#### 技术确认
+- [ ] 版本号和构建号正确
+- [ ] Git 分支和标签创建
+- [ ] 构建产物验证和签名
+- [ ] 生产环境配置正确
+- [ ] API 后端服务就绪
+- [ ] CDN 和静态资源就绪
+
+#### 发布窗口确认
+- [ ] 发布时间窗口确认
+- [ ] 依赖服务发布时间协调
+- [ ] 值班人员到位
+- [ ] 应急预案准备就绪
+- [ ] 用户通知准备（如需）
+
+### 十一、发布后验证
+
+#### 线上验证
+- [ ] 生产环境冒烟测试通过
+- [ ] 关键功能流程验证
+- [ ] 监控数据正常
+- [ ] 用户反馈监控
+- [ ] 应用商店审核通过
+
+#### 数据验证
+- [ ] 用户数据迁移验证
+- [ ] 数据统计准确性验证
+- [ ] 业务指标监控正常
+- [ ] 异常数据告警配置
+
+### 十二、复盘与优化
+
+#### 发布复盘
+- [ ] 发布过程记录和总结
+- [ ] 问题和解决方案归档
+- [ ] 检查清单优化更新
+- [ ] 团队经验分享
+- [ ] 下次发布改进计划
+
+### 参考资料
+- Google Play 发布指南：https://developer.android.com/distribute
+- App Store 发布指南：https://developer.apple.com/app-store/
+- 移动应用安全最佳实践：https://owasp.org/www-project-mobile-security/