231 lines
5.4 KiB
Markdown
231 lines
5.4 KiB
Markdown
# Android 개발 환경 설정 가이드
|
|
|
|
## 방법 1: Android Studio 설치 (권장)
|
|
|
|
### 1단계: Android Studio 다운로드 및 설치
|
|
|
|
1. **다운로드**: https://developer.android.com/studio
|
|
2. 설치 파일 실행
|
|
3. 설치 시 다음 항목 모두 선택:
|
|
- ✅ Android SDK
|
|
- ✅ Android SDK Platform
|
|
- ✅ Android Virtual Device
|
|
- ✅ Performance (Intel HAXM)
|
|
|
|
### 2단계: SDK 설치 확인
|
|
|
|
1. Android Studio 실행
|
|
2. 우측 상단 **More Actions** > **SDK Manager** 클릭
|
|
3. **SDK Platforms** 탭에서 설치:
|
|
- ✅ Android 14.0 (API Level 34)
|
|
- ✅ Android 13.0 (API Level 33)
|
|
|
|
4. **SDK Tools** 탭에서 설치:
|
|
- ✅ Android SDK Build-Tools 34
|
|
- ✅ Android SDK Command-line Tools
|
|
- ✅ Android SDK Platform-Tools
|
|
- ✅ Android Emulator
|
|
- ✅ Google Play services
|
|
|
|
5. **Apply** 클릭하여 설치
|
|
|
|
### 3단계: 환경 변수 설정
|
|
|
|
#### Windows 10/11
|
|
|
|
1. **시작** 메뉴에서 "환경 변수" 검색
|
|
2. **시스템 환경 변수 편집** 클릭
|
|
3. **환경 변수** 버튼 클릭
|
|
|
|
#### 시스템 변수 추가
|
|
|
|
**ANDROID_HOME** 추가:
|
|
- 변수 이름: `ANDROID_HOME`
|
|
- 변수 값: `C:\Users\[사용자명]\AppData\Local\Android\Sdk`
|
|
|
|
(사용자명은 본인의 Windows 사용자명으로 변경)
|
|
|
|
**JAVA_HOME** 추가 (JDK 설치 후):
|
|
- 변수 이름: `JAVA_HOME`
|
|
- 변수 값: `C:\Program Files\Eclipse Adoptium\jdk-11.0.21.9-hotspot`
|
|
|
|
(설치된 JDK 버전에 따라 경로가 다를 수 있음)
|
|
|
|
#### Path 변수 수정
|
|
|
|
**Path** 변수를 찾아서 **편집** 클릭 후 다음 추가:
|
|
```
|
|
%ANDROID_HOME%\platform-tools
|
|
%ANDROID_HOME%\tools
|
|
%ANDROID_HOME%\tools\bin
|
|
%JAVA_HOME%\bin
|
|
```
|
|
|
|
### 4단계: 환경 변수 적용 확인
|
|
|
|
**PowerShell을 새로 열고** 다음 명령어 실행:
|
|
|
|
```powershell
|
|
# Android SDK 확인
|
|
$env:ANDROID_HOME
|
|
|
|
# adb 명령어 확인
|
|
adb version
|
|
|
|
# Java 확인
|
|
java -version
|
|
```
|
|
|
|
모두 정상적으로 출력되면 성공!
|
|
|
|
---
|
|
|
|
## 방법 2: 명령줄 도구만 설치 (경량)
|
|
|
|
Android Studio 없이 SDK만 설치하는 방법입니다.
|
|
|
|
### 1단계: JDK 설치
|
|
|
|
1. **다운로드**: https://adoptium.net/
|
|
2. **JDK 11 (LTS)** 선택
|
|
3. 설치 시 "Add to PATH" 옵션 체크
|
|
|
|
### 2단계: Android Command Line Tools 다운로드
|
|
|
|
1. https://developer.android.com/studio#command-tools 접속
|
|
2. **Command line tools only** 섹션에서 Windows 버전 다운로드
|
|
3. 압축 해제
|
|
|
|
### 3단계: SDK 설치
|
|
|
|
```powershell
|
|
# SDK 디렉토리 생성
|
|
New-Item -ItemType Directory -Path "$env:LOCALAPPDATA\Android\Sdk" -Force
|
|
|
|
# cmdline-tools 이동
|
|
Move-Item "압축해제한폴더\cmdline-tools" "$env:LOCALAPPDATA\Android\Sdk\cmdline-tools\latest"
|
|
|
|
# SDK Manager로 필요한 패키지 설치
|
|
cd "$env:LOCALAPPDATA\Android\Sdk\cmdline-tools\latest\bin"
|
|
|
|
.\sdkmanager.bat "platform-tools" "platforms;android-34" "build-tools;34.0.0" "cmdline-tools;latest"
|
|
```
|
|
|
|
### 4단계: 환경 변수 설정
|
|
|
|
위의 "방법 1 - 3단계"와 동일하게 설정
|
|
|
|
---
|
|
|
|
## 환경 변수 설정 자동화 스크립트
|
|
|
|
PowerShell을 **관리자 권한**으로 실행 후:
|
|
|
|
```powershell
|
|
# Android SDK 경로 (본인의 사용자명으로 변경)
|
|
$androidHome = "C:\Users\$env:USERNAME\AppData\Local\Android\Sdk"
|
|
|
|
# 시스템 환경 변수 설정
|
|
[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", $androidHome, "User")
|
|
|
|
# Path에 추가
|
|
$currentPath = [System.Environment]::GetEnvironmentVariable("Path", "User")
|
|
$newPaths = @(
|
|
"$androidHome\platform-tools",
|
|
"$androidHome\tools",
|
|
"$androidHome\tools\bin"
|
|
)
|
|
|
|
foreach ($newPath in $newPaths) {
|
|
if ($currentPath -notlike "*$newPath*") {
|
|
$currentPath += ";$newPath"
|
|
}
|
|
}
|
|
|
|
[System.Environment]::SetEnvironmentVariable("Path", $currentPath, "User")
|
|
|
|
Write-Host "환경 변수 설정 완료!" -ForegroundColor Green
|
|
Write-Host "PowerShell을 재시작하세요." -ForegroundColor Yellow
|
|
```
|
|
|
|
---
|
|
|
|
## 설치 확인 체크리스트
|
|
|
|
PowerShell을 **새로 열고** 다음 명령어들이 모두 작동하는지 확인:
|
|
|
|
```powershell
|
|
# 1. Java 확인
|
|
java -version
|
|
# 출력 예: openjdk version "11.0.21"
|
|
|
|
# 2. Android SDK 확인
|
|
$env:ANDROID_HOME
|
|
# 출력 예: C:\Users\사용자명\AppData\Local\Android\Sdk
|
|
|
|
# 3. ADB 확인
|
|
adb version
|
|
# 출력 예: Android Debug Bridge version 1.0.41
|
|
|
|
# 4. Gradle 확인 (프로젝트 내)
|
|
cd D:\workspace_dtgapk\android
|
|
.\gradlew --version
|
|
# Gradle 버전 정보 출력
|
|
```
|
|
|
|
모두 정상 출력되면 **환경 설정 완료**!
|
|
|
|
---
|
|
|
|
## 문제 해결
|
|
|
|
### "adb를 찾을 수 없습니다"
|
|
|
|
1. PowerShell을 완전히 종료 후 재시작
|
|
2. 환경 변수가 제대로 설정되었는지 확인
|
|
3. 컴퓨터 재시작
|
|
|
|
### "JAVA_HOME이 설정되지 않았습니다"
|
|
|
|
1. JDK 11 설치: https://adoptium.net/
|
|
2. JAVA_HOME 환경 변수 설정
|
|
3. PowerShell 재시작
|
|
|
|
### SDK Manager 오류
|
|
|
|
```powershell
|
|
# SDK 라이선스 동의
|
|
cd "$env:ANDROID_HOME\cmdline-tools\latest\bin"
|
|
.\sdkmanager.bat --licenses
|
|
# 모든 라이선스에 'y' 입력
|
|
```
|
|
|
|
---
|
|
|
|
## 다음 단계
|
|
|
|
환경 설정이 완료되면:
|
|
|
|
```powershell
|
|
# 프로젝트 디렉토리로 이동
|
|
cd D:\workspace_dtgapk
|
|
|
|
# Debug APK 빌드 (테스트용)
|
|
.\build-debug-apk.bat
|
|
|
|
# 또는 Release APK 빌드 (배포용)
|
|
.\build-apk.bat
|
|
```
|
|
|
|
---
|
|
|
|
## 참고 자료
|
|
|
|
- [Android Studio 다운로드](https://developer.android.com/studio)
|
|
- [JDK 다운로드](https://adoptium.net/)
|
|
- [React Native 환경 설정](https://reactnative.dev/docs/environment-setup)
|
|
- [Android 개발자 가이드](https://developer.android.com/studio/intro)
|
|
|
|
|
|
|