React Native React Native

一些 React Native 开发上遇到的问题简单记录。

修改 App 在手机上展示的名称

Android

修改 android/app/src/main/res/values/strings.xml 配置

<resources>
  <string name="app_name">这里填写名称</string>
</resources>

iOS

修改 ios/<应用名称>/Info.plist 配置

<key>CFBundleDisplayName</key>
<string>这里填写名称</string>

修改 App 在手机上展示的图标

Android

修改替换 android/app/src/main/res/mipmap-(*) 下面的图标

图标分为方形图标(ic_launcher.png) 和圆形图标(ic_launcher_round.png)

iOS

修改 ios/<应用名称>/Images.xcassets/AppIcon.appiconset/Contents.json 配置，及修改配置目录 ios/<应用名称>/Images.xcassets/AppIcon.appiconset 下的图标文件。

通过 xcode 下图拖拽更换图标更方便。

判断 Release/Debug 用于调试

Android

修改 android/app/src/main/res/values/strings.xml 配置

// 在Android Studio项目中
if(BuildConfig.DEBUG){
  // debug模式
}else{
  // release模式
}

iOS

#ifdef DEBUG
   // debug模式
#else
    //release 模式
#endif

React Native

if (__DEV__) {
  // debug 模式
} else {
  // release 模式
}

开发模式弹出开发者菜单刷新应用

命令行支持打开开发者菜单，和其它的一些操作

r - 重新加载应用
d - 打开开发者菜单
i - 在 iOS 上运行
a - 在 Android 上运行

Android

按两次 R 键或从开发者菜单(⌘M)中选择重新加载(Reload)以预览您的更改。

如果没有起作用可以在命令行使用 adb shell input keyevent 82 命令唤起开发者菜单

iOS

使用 ⌘R 让您的 IOS 模拟器重新加载本地项目，使用 ⌘T 弹出开发者菜单。

设置允许 HTTP 请求访问

Android

创建配置文件 android/app/src/main/res/xml/network_security_config.xml 内容如下：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

修改配置 android/app/src/main/AndroidManifest.xml

<application
  android:name=".MainApplication"
  android:label="@string/app_name"
  android:icon="@mipmap/ic_launcher"
  android:roundIcon="@mipmap/ic_launcher_round"
  android:allowBackup="false"
+  android:networkSecurityConfig="@xml/network_security_config"
  android:theme="@style/AppTheme">
</application>

iOS

修改 ios/<应用名称>/Info.plist 配置

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

真机配置 IP 调试

配置说明

⚠️ 首先保证真机和 pc 在同一个局域网络下。
摇晃你的实体真机，调出配置弹窗。
团队开发可以不安装开发环境。

摇晃手机 => Configure Bundler => 设置 ip:端口

默认端口：8081 可以通过参数更改默认端口 react-native start --port 9999

Android 设置

iOS 设置

设置 Build Configuration 为 Debug 模式连接真机打包 APP。

Xcode => Product => Scheme => Edit Scheme... => Run => Info => Build Configuration => Debug

Xcode 不用数据线真机调试

通过菜单 Xcode => Product => Destination => Add Additional Simulators... 打开设置界面，勾选 Connect via network。

如果是第一次操作，可能会需要先进行配对操作；

可在以上面弹出的界面中，点击左侧的设备，然后右健选unpair device。
然后再去勾选 connect via network；
这时手机上会提示信任界面，点击确认即可。

打包修改 APP 版本号

Android

修改 android/app/build.gradle 配置

android {
  .....
  defaultConfig {
    ....
    versionName "2.1.1"
  }
}

iOS

修改 ios/<应用名称>/Info.plist 配置

<key>CFBundleShortVersionString</key>
<string>1.2.0</string>

常见错误

应用反应缓慢，出现卡顿问题

可能存在的问题

查看是否 console 日志打印过度造成。
React Native Debugger 页面放到最前面，浏览器窗口不要放到选项卡里面。

Android: Gradle project sync failed.

问题解决方法

在 Android Gradle 同步失败，导致项目无法启动，只需重新同步 Gradle 即可(可能需要翻墙)，方法如下图。

Android: The device needs more free storage to install the application

问题解决方法

Android: Cannot convert string value 'UNIFIED_TEST_PLATFORM'

convert string value 'UNIFIED_TEST_PLATFORM' to an enum value of type 'com.android.builder.model.AndroidGradlePluginProjectFlags$BooleanFlag' (valid case insensitive values: APPLICATION_R_CLASS_CONSTANT_IDS, TEST_R_CLASS_CONSTANT_IDS, TRANSITIVE_R_CLASS, JETPACK_COMPOSE, ML_MODEL_BINDING)