Cài đặt môi trường chạy và build ứng dụng React Native

Chuẩn bị môi trường và cài đặt tất cả thành phần cần thiết trước khi chạy buid ứng dụng trên Windows

Yêu cầu hệ thống

Hệ điều hành: Windows 10 hoặc 11 (64-bit)
RAM ≥ 8GB (tốt nhất ≥16GB để chạy Android Emulator)
Node.js ≥ 18
JDK 17 (OpenJDK 17)

Cài đặt Node.js và package manager

Node.js

Tải từ https://nodejs.org/ (phiên bản LTS ≥18)
Kiểm tra cài đặt:

node -v
npm -v

Package manager

Mặc định Node đi kèm npm, nhưng có thể dùng pnpm

npm install -g pnpm

Cài đặt Java JDK

Java JDK 17 là bắt buộc để build Android với React Native 0.72+ và Expo SDK 51.
Tải OpenJDK 17 từ Adoptium Temurin bản dành cho Window .msi

Cài đặt và thêm vào PATH (nếu chưa tự thêm):

java -version

Kết quả: openjdk version "17.x.x"

Cài đặt Android Studio và Android SDK

Tải Android Studio: https://developer.android.com/studio
Khi cài đặt, chọn: Android SDK

Android SDK Platform 33 (hoặc version compileSdk của project)
Android SDK Build Tools 33.x.x
Android Emulator (nếu muốn chạy giả lập)

Nếu tải Android SDK Command-line Tools, bạn có thể giải nén vào bất kỳ thư mục nào trên máy

C:\Android\Sdk

Cấu trúc sau khi giải nén (ví dụ Linux/macOS):


~/Android/Sdk/
  └── cmdline-tools/
       └── latest/
           ├── bin/
           ├── lib/
           └── ...

Bạn phải đổi tên thư mục con thành latest (nếu khi giải nén nó có tên như cmdline-tools hoặc cmdline-tools-version_xx).

Tải platform-tools và giải nén vào thư mục C:\Android\Sdk

Kiểm tra SDK tools:

adb --version

Cài đặt Gradle (dùng cho React Native local build)

Gradle wrapper thường có sẵn trong project (gradlew.bat).
Nếu bị lỗi hoặc muốn tạo lại wrapper:
Tải Gradle 8.3 Binary: https://gradle.org/releases/

Giải nén, ví dụ: C:\Gradle\gradle-8.3
Thêm vào PATH:

set PATH=%PATH%;C:\Gradle\gradle-8.3\bin

Kiểm tra:

gradle --version

Chuẩn bị Project React Native + Expo

Cài Expo CLI (local):

npm install -g expo-cli

Kiểm tra:

expo --version

Nếu project dùng EAS:

npm install -g eas-cli eas --version

Cài dependencies của project:

cd D:\project\react_native\lienvu pnpm install

Kiểm tra Gradle wrapper và Kotlin

Mở android/gradle/wrapper/gradle-wrapper.properties
Chỉnh Gradle version:

distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip

Mở android/build.gradle
Chỉnh Kotlin version tương thích:

ext { kotlinVersion = '1.8.10' }

Chuẩn bị thiết bị Android / Emulator

USB Debugging trên điện thoại: bật Developer Options → USB Debugging
Hoặc Android Emulator: mở Android Studio → AVD Manager → chọn device → Start

Kiểm tra thiết bị:

adb devices

Phải hiển thị thiết bị hoặc emulator.

Chạy ứng dụng

Build & chạy trên thiết bị/emulator:

npx expo run:android

Lệnh này sẽ biên dịch native code bằng Gradle
Cài app vào thiết bị/emulator
Chạy Metro bundler cho JS/TS code

Hoặc nếu muốn build ra file .apk

npx expo prebuild

Lệnh này sẽ tạo thư mục android và ios cho bạn (nếu chưa có), chuyển dự án sang dạng prebuild (bare workflow).

Sau khi chạy xong, bạn có thể build APK local bằng các bước sau:

Cài dependencies nếu cần:

npm install

Build APK:

cd android
gradlew.bat assembleRelease

File APK sẽ nằm ở: android/app/build/outputs/apk/release/app-release.apk

Lưu ý:

Luôn mở CMD hoặc PowerShell mới sau khi thay đổi PATH.
Nếu gặp lỗi Kotlin Unresolved reference → check lại Gradle + Kotlin version trong project.
Nếu Metro bundler không chạy → thử npx expo start -c để clear cache.