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 模式
}
开发模式弹出开发者菜单刷新应用
Android
按两次 R 键或从开发者菜单(⌘M)中选择重新加载(Reload)以预览您的更改。
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
和 端口
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 即可(可能需要翻墙),方法如下图。

iOS: library not found for -lDoubleConversion.
问题解决方法
Xcode 打开工程文件错误,使用 *.xcodeproj
打开工程会报这个错误。
请打开
*.xcworkspace
的工程文件,错误将得到解决。