Chenyuwen/react-native-mask-segment-canvas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3a3f07628d
react-native-mask-segment-c.../docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/troubleshooting.md
a1518 bea6de3767 Add Docusaurus documentation site with i18n support 
- Docusaurus 3.7.0 with both English and Chinese (zh-CN) locales
- Full API reference split into structured pages
- Homepage with hero, feature cards, and quick start section
- GitHub Actions workflow for auto-deployment to GitHub Pages

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-02 23:25:56 -07:00

1.0 KiB
Raw Blame History

id title
troubleshooting 故障排除

🔧 故障排除

iOS pod install 失败

cd ios
bundle install
bundle exec pod install --repo-update

Android 构建错误

cd android && ./gradlew clean && cd ..

分割失败 / 零区域

  • 确认 originUrl / maskUrl 可访问
  • 确认遮罩语义颜色与 semanticColors 配置匹配
  • 检查 Metro 日志中的 [MaskSegment] / [⏱ ...] 输出

虚线轮廓错位 / 多余轮廓

  • 轮廓从遮罩像素外部轮廓生成；长按仅显示触摸点下的连通分量
  • 初始轮播仅显示每个语义区域的最大连通分量

常见重复模块错误

症状：

  • SkiaPictureView must be a function (received 'undefined')
  • createAnimatedNode: Animated node[...] already exists

解决方案：

  1. 从 example/metro.config.js 复制 singletonPackages + extraNodeModules + blockList 模式
  2. 在 index.js 顶部按顺序导入 gesture-handler → reanimated → skia
  3. 使用 --reset-cache 重启 Metro 并重新安装应用