跳到主要内容
版本:Next

调试原生代码

访问日志

你可以在应用运行时,通过终端使用以下命令来显示 iOS 或 Android 应用的原生日志:

# Android:
npx react-native log-android
# 或者,iOS:
npx react-native log-ios

你也可以在 iOS Simulator 中通过 Debug > Open System Log… 访问这些日志,或者在 Android 应用运行于设备或模拟器时,在终端中运行 adb logcat "*:S" ReactNative:V ReactNativeJS:V

💡 自定义原生日志

如果你正在编写 Native Module,并希望为模块添加自定义日志以便调试,可以使用以下方法:

Android (Java/Kotlin)

在你的原生模块中,使用 Log 类添加可在 Logcat 中查看的日志:

Java
import android.util.Log;

private void log(String message) {
Log.d("YourModuleName", message);
}

要在 Logcat 中查看这些日志,请使用以下命令,将 YourModuleName 替换为你的自定义标签:

adb logcat "*:S" ReactNative:V ReactNativeJS:V YourModuleName:D

iOS (Objective-C/Swift)

在你的原生模块中,使用 NSLog 记录自定义日志:

Objective-C
NSLog(@"YourModuleName: %@", message);

或者,在 Swift 中:

Swift
print("YourModuleName: \(message)")

运行应用时,这些日志会显示在 Xcode 控制台中。

在原生 IDE 中调试

在处理原生代码时,例如编写原生模块时,你可以从 Android Studio 或 Xcode 启动应用,并像构建标准原生应用一样利用原生调试功能(设置断点等)。

另一种方式是使用 React Native CLI 运行应用,然后将原生 IDE(Android Studio 或 Xcode)的原生调试器附加到该进程。

Android Studio

在 Android Studio 中,你可以通过菜单栏中的“Run”选项,点击“Attach to Process...”,然后选择正在运行的 React Native 应用来完成此操作。

Xcode

在 Xcode 中,点击顶部菜单栏的“Debug”,选择“Attach to process”选项,然后在“Likely Targets”列表中选择该应用。