2026/4/5 11:32:14
网站建设
项目流程
怎么看网站是否被百度惩罚,做微信推送网站,页面设计参评,wordpress添加图片从零开始#xff1a;Windows 上手 React Native 开发环境搭建实战指南 你是不是也经历过这样的时刻#xff1f;兴致勃勃想用 React Native 写个跨平台 App#xff0c;结果刚打开命令行输入 npx react-native run-android #xff0c;一串红字就砸了过来——“找不到 SDK…从零开始Windows 上手 React Native 开发环境搭建实战指南你是不是也经历过这样的时刻兴致勃勃想用 React Native 写个跨平台 App结果刚打开命令行输入npx react-native run-android一串红字就砸了过来——“找不到 SDK”、“Gradle 失败”、“adb 不是命令”……最后只能无奈放弃。别急。这不是你的问题而是环境配置本身就有门槛。React Native 看似是一套 JavaScript 框架但它的背后其实依赖着一套复杂的工具链Node.js 跑脚本、JDK 编译 Java 代码、Android SDK 提供原生构建能力再加上一堆环境变量串联起来——任何一个环节出错整个流程就会中断。尤其是在 Windows 平台下路径空格、权限控制、系统兼容性等问题更是雪上加霜。但好消息是只要搞清楚每个组件的职责和协作逻辑这套“看似混乱”的体系完全可以被我们掌控。本文不讲套话不堆术语带你一步步亲手搭起一个稳定可用的 React Native 开发环境让你真正跑通第一个 App。Node.js一切的起点React Native 是基于 JavaScript 的框架而要在电脑上运行 JS 脚本不是浏览器里就需要Node.js。它就像发动机驱动着npx、npm install、Metro 打包器这些关键工具。安装要点去官网 https://nodejs.org 下载LTS 版本长期支持版推荐使用.msi安装包会自动帮你配置好基本的PATH截至 2024 年React Native 主流适配的是Node.js 16 或 18不要盲目追新到 20⚠️ 小心陷阱如果你已经装了 Node.js 却在 CMD 中执行node -v报错“不是内部或外部命令”说明安装时没写入系统路径或者你手动卸载后残留了注册表项。验证安装打开命令提示符CMD 或 PowerShellnode -v npm -v正常输出应类似v18.17.0 9.6.7如果失败请检查是否已将C:\Program Files\nodejs\加入系统PATH。进阶建议推荐使用 nvm-windows 来管理多个 Node 版本。比如项目 A 需要 v16项目 B 需要 v18切换起来非常方便。JDK 11为 Android 构建铺路虽然你写的是 JavaScript但最终生成的 APK 文件底层还是靠 Java/Kotlin 构建的。这就离不开JDKJava Development Kit。React Native 在打包 Android 应用时会调用 Gradle 工具来编译原生模块而Gradle 必须运行在 JDK 环境下。为什么是 JDK 11React Native 0.68 正式弃用对 JDK 8 的支持Android Studio 默认捆绑 JDK 11Temurin HotSpot使用旧版本可能导致Could not resolve all artifacts for configuration这类诡异错误安装方式前往 Eclipse Adoptium 下载OpenJDK 11选择 Temurin 发行版安装即可。关键配置JAVA_HOME这是最容易被忽略却最关键的一步打开“此电脑” → 右键“属性” → “高级系统设置” → “环境变量”在“系统变量”中新建变量名JAVA_HOME 变量值C:\jdk-11.0.18.10-hotspot ← 根据实际路径填写修改Path添加%JAVA_HOME%\bin✅ 最佳实践尽量避免把 JDK 安装在带空格的路径下如C:\Program Files\...。Windows 对引号处理不稳定容易导致某些构建脚本解析失败。建议直接安装到C:\jdk11这样的简洁路径。验证是否成功java -version javac -version你应该看到输出包含11.0.xx字样。Android Studio 与 SDK真正的“安卓引擎”如果说 Node.js 和 JDK 是地基那Android Studio SDK就是你造房子要用的钢筋水泥。即使你不打算用 Android Studio 写代码你也必须安装它——因为只有它才能完整安装和管理 Android SDK 组件。下载与安装访问 Android 开发者官网 下载 Android Studio 安装包一路默认选项安装即可。首次启动可以选择“Do not import settings”。启动 SDK Manager进入主界面后点击菜单栏Tools SDK Manager确保勾选并安装以下核心组件组件名称作用Android SDK Platform 33目标 API 级别推荐Android SDK Build-Tools 34.0.0编译 APK 所需工具Android SDK Platform-Tools包含adbAndroid Emulator模拟器本体Android SDK Tools (Obsolete)某些老 CLI 仍依赖 注意Build-Tools 版本不必强求 34.0.0只要是较新的版本就行Gradle 会自动匹配。记录 SDK 路径默认路径通常是C:\Users\你的用户名\AppData\Local\Android\Sdk记住这个路径接下来要用来设置环境变量。环境变量让所有工具“说同一种语言”前面装了一堆软件但如果它们彼此找不到对方照样没法工作。这就需要通过环境变量把它们连成一张网。必须设置的变量变量名推荐值说明JAVA_HOMEC:\jdk11指向 JDK 安装目录ANDROID_SDK_ROOTC:\Users\xxx\AppData\Local\Android\Sdk推荐使用的现代变量或ANDROID_HOME同上兼容旧工具链建议同时设Path添加项%JAVA_HOME%\bin%ANDROID_SDK_ROOT%\platform-tools%ANDROID_SDK_ROOT%\emulator%ANDROID_SDK_ROOT%\tools\bin使命令全局可用 说明ANDROID_HOME已逐步被弃用但很多工具仍在读取它所以建议两个都设。如何修改环境变量Win S 搜索“环境变量”点击“编辑系统环境变量”点击“环境变量”按钮在“系统变量”区域进行新增/修改所有更改完成后关闭并重新打开终端才能生效一键检测脚本快速判断环境状态你可以创建一个简单的批处理文件check_env.bat双击运行就能查看当前环境健康状况echo off echo. echo 环境检测报告 echo. echo Node.js 版本: node -v echo. echo npm 版本: npm -v echo. echo Java 运行时: java -version echo. echo Java 编译器: javac -version echo. echo ADB 调试桥: adb version echo. echo ANDROID_SDK_ROOT: %ANDROID_SDK_ROOT% echo JAVA_HOME: %JAVA_HOME% echo. pause保存后双击运行如果所有命令都能正确返回信息说明你的基础环境已经准备就绪。创建第一个 React Native 项目万事俱备现在可以正式初始化项目了。初始化项目npx react-native-community/clilatest init MyAwesomeApp等待几分钟CLI 会自动生成完整的项目结构并安装依赖。 提示国内网络可能卡在下载模板阶段。可尝试开启代理或使用镜像源加速 npm/yarn。启动开发服务器cd MyAwesomeApp npx react-native start这会启动 Metro Bundler默认监听localhost:8081负责实时打包 JS 代码。保持这个窗口运行。运行到安卓设备新开一个终端窗口执行npx react-native run-android此时会发生一系列操作1. 检查是否有连接的设备真机或模拟器2. 调用 Gradle 构建 debug APK3. 安装 APK 到设备4. 启动应用并建立调试连接如果没有设备怎么办React Native 不会自动启动模拟器。你需要先手动打开一个虚拟设备。启动模拟器步骤打开 Android Studio进入AVD ManagerAndroid Virtual Device Manager创建一个 Pixel 设备如 Pixel 4 XLAPI 33点击绿色三角按钮启动模拟器等模拟器完全加载后再运行npx react-native run-android。也可以直接用命令行启动emulator -avd Pixel_4_XL_API_33⚠️ 若提示emulator 不是命令请确认%ANDROID_SDK_ROOT%\emulator是否已加入PATH。常见问题与解决方案真实踩坑记录❌ 错误1Command failed: gradlew.bat app:installDebug原因Gradle 下载依赖太慢甚至超时。解决方法在android/gradle.properties中添加阿里云镜像systemProp.http.proxyHostmaven.aliyun.com systemProp.http.proxyPort80或者更彻底的方式是在android/build.gradle中替换仓库源allprojects { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/jcenter } maven { url https://maven.aliyun.com/repository/central } google() mavenCentral() } }❌ 错误2Unable to load JS bundle表现App 启动后白屏提示“Unable to download JS bundle”原因Metro 服务未启动或手机无法访问主机 IP解决方法1. 确保npx react-native start正在运行2. 在设备上摇一摇调出开发者菜单3. 选择“Dev Settings” “Debug server host port for device”4. 输入你的电脑局域网 IP 端口例如192.168.31.100:80815. 回到首页刷新 JS 获取本机 IP在 CMD 执行ipconfig找 IPv4 地址❌ 错误3SDK location not found原因项目缺少local.properties文件Gradle 找不到 SDK 路径解决方法在android/目录下新建文件local.properties内容为sdk.dirC:\\Users\\YourName\\AppData\\Local\\Android\\Sdk注意路径中的反斜杠要转义为双反斜杠。❌ 错误4模拟器黑屏/卡在启动画面原因CPU 虚拟化未启用或 HAXM/WHPX 未安装解决方法1. 进入 BIOS 开启 Intel VT-x / AMD-V2. 在 Android Studio SDK Manager 中安装Intel x86 Atom_64 System Image3. 安装Windows Hypervisor Platform (WHPX)- 控制面板 → 程序 → 启用或关闭 Windows 功能- 勾选Windows Hypervisor Platform- 重启电脑性能优化建议让构建更快一点在android/gradle.properties中加入以下配置org.gradle.daemontrue org.gradle.paralleltrue org.gradle.configureondemandtrue kotlin.daemon.jvm.options-Xmx2048m这些参数可以让 Gradle 使用守护进程、并行编译显著提升后续构建速度。写在最后环境只是开始当你终于看到那个写着 “Welcome to React Native” 的蓝色界面出现在模拟器上时你会明白这一路的折腾都是值得的。但也要清醒认识到搭建环境只是第一步。后面还有热重载调试、原生模块集成、性能优化、发布签名等一系列挑战等着你。不过至少现在你已经有了一个坚实的基础。下次有人问你“Windows 能不能做 React Native” 你可以自信地说“不仅能我还亲手搭过。”如果你在过程中遇到其他奇怪的问题欢迎留言交流。毕竟每一个成功的环境背后都曾有一打失败的尝试。