# 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)