react-native-beidou 1.0.0

package/README.md

@@ -0,0 +1,154 @@
+# RN 项目
+
+开发分支: h5-dev
+
+环境搭建：https://reactnative.cn/docs/environment-setup
+
+react 中文网：https://www.php.cn/doc/react/index.html 学习函数组件、类组件可以先不学
+
+es6 教程：https://www.runoob.com/w3cnote
+
+useMock：https://www.usemock.com/login >>>>>>>>>在【useMock 协作项目】
+
+UI 库: https://rn.mobile.ant.design/docs/react/introduce-cn 版本：`5.2.3`
+
+开发工具： vscode, 插件：eslint(自动格式化)、react-native-snippets(代码提示)
+
+.vscode 可以扩展自定义模板，现有创建组件模板 rnc 指令
+
+`node: v18.17.1`  
+`yarn: 1.22.22`
+
+新建页面、组件规范： pages、components、assets 以页面维度划分
+
+# 安卓 gif 与 webp 支持
+
+项目的 android 目录输入
+cd android
+.\gradlew app:dependencies --configuration releaseRuntimeClasspath
+
+# 常用脚本
+
+```
+   "mock": "nodemon ./mock/mock.js",
+    "android": "gulp dev-android",
+    "ios": "gulp dev-ios",
+    "start": "gulp dev-start",
+    "test": "jest",
+    "build": "gulp default",
+    "upload": "gulp upload",
+    "build:dll-custom": "gulp build-custom",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "bundle:analysis": "react-native-bundle-visualizer"
+```
+
+例如
+
+```
+开发启动命令
+yarn android --pageName=页面名称
+页面名称：src/pages下的页面入口文件名（不带后缀）
+
+
+使用metro配置自定义拆包：
+业务包（页面级别）可以直接使用页面名字，如Demo。打包配置走metro.main.config.js；
+非业务包（包括node_modules里的第三方插件、utils自定义公共方法）需要在custom.config.js里配置。打包配置走metro.common.config.js
+输出：bundle/(ios|android)-${pageName}
+splitCache: 打包信息缓存，目前之缓存非业务包信息，带_origin为路径信息缓存，不带的是打包id缓存
+yarn build:dll-custom --pageName=dll
+yarn build:dll-custom --pageName=utils
+yarn build:dll-custom --pageName=Demo
+
+添加参数：
+--pageName=<页面名称>  指定要打包的页面名称（必填）
+--ios                只打iOS包，不打Android包
+--android            只打Android包，不打iOS包
+--sourceMap          生成sourcemap文件，用于错误堆栈符号化
+
+示例：
+yarn build:dll-custom --pageName=Demo1 --ios --sourceMap
+```
+
+# js 能力相关的
+
+1.如果依赖 js 能力的数据，可以用 async await
+
+2.不依赖的话，用.then 的方式或者不需要接收的方式，防止阻塞后面代码执行
+
+```
+// js能力调用方法
+    try {
+      const data = await callNativeMethod({
+        businessName: 'userStatus',
+        debug: false,
+        ...剩余参数(不要传success和error),
+      });
+      // succes回调
+      console.log('%c Line:141 🍰 data', 'color:#7f2b82', data);
+    } catch (error) {
+      // error回调
+      console.log('%c Line:148 🍰 error', 'color:#b03734', error);
+    }
+
+// 参考商城写法
+// useInfo 更新调用接口
+  useEffect(() => {
+    !!userInfo && getData();
+  }, [userInfo]);
+
+  useEffect(() => {
+    // 强登isForceLogin
+    loginInfo({isForceLogin: false}).then((res: any) => {
+      setUserInfo(res);
+    });
+  }, []);
+```
+
+# 开发在线调试
+
+1.yarn build
+
+2.yarn upload 上传 jsbundle 到服务器
+
+3.客户端设置页输入 jsbundle 地址，开启调试模式
+
+# 本地 mock
+
+启动命令 `yarn mock`
+
+根据 data 里的 json 文件名自动创建路由，修改文件自动启动服务
+
+例如
+
+users.json => http://localhost:3000/api/users
+
+# 注意事项
+
+1. 定时器相关的，都要有清除逻辑，不然会报内存泄漏, 接收的地方都用 ref
+2. 页面如果要用不涉及更新的全局变量，不要写在组件外面，都用 ref
+3. `react-native-swiper`组件废弃，新页面采用`react-native-reanimated-carousel`
+
+# 符号化错误堆栈（Symbolication）
+
+当React Native应用崩溃时，错误堆栈通常包含混淆后的代码位置，使调试变得困难。使用symbolicate命令可以将这些位置转换为源代码中的实际位置。
+
+使用方法： 文件路径相对于工程根目录
+
+```
+yarn symbolicate --sourcemap=<sourcemap文件路径> --stack=<错误堆栈文件路径>
+```
+
+参数说明：
+- `--sourcemap`：指定sourcemap文件的路径，例如：`CT00010.jsbundle.map`。该文件是在打包时生成的，包含源代码和打包后代码的映射关系。
+- `--stack`：指定包含错误堆栈信息的文本文件路径，例如：`error.txt`。该文件包含应用崩溃时的错误堆栈信息。
+
+注意事项：
+- 打包时需要添加`--sourceMap`参数才会生成sourcemap文件，例如：`yarn build --sourceMap`或`yarn build:dll-custom --pageName=Demo --sourceMap`
+- 符号化过程使用`metro-symbolicate`工具，会自动将混淆后的代码位置映射回源代码位置
+
+示例：
+```
+yarn symbolicate --sourcemap=CT00010.jsbundle.map --stack=error.txt
+```
+
+执行后，将输出符号化后的错误堆栈信息，帮助开发者快速定位问题所在位置。

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -0,0 +1,2 @@
+#Mon Aug 04 14:01:07 CST 2025
+gradle.version=7.3.3

package/android/.gradle/config.properties

@@ -0,0 +1,2 @@
+#Mon Aug 04 11:28:33 CST 2025
+java.home=/Applications/Android Studio 3.app/Contents/jbr/Contents/Home

package/android/.idea/AndroidProjectSystem.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AndroidProjectSystem">
+    <option name="providerId" value="com.android.tools.idea.GradleProjectSystem" />
+  </component>
+</project>