chpark/DTGAPK

Fork 0

Files

chpark 4f7aa593a1 Initial commit: LogiStream Android WebView App

2025-12-08 11:54:34 +09:00

5.4 KiB

Raw Permalink Blame History

Android 개발 환경 설정 가이드

방법 1: Android Studio 설치 (권장)

1단계: Android Studio 다운로드 및 설치

다운로드: https://developer.android.com/studio
설치 파일 실행
설치 시 다음 항목 모두 선택:
- ✅ Android SDK
- ✅ Android SDK Platform
- ✅ Android Virtual Device
- ✅ Performance (Intel HAXM)

2단계: SDK 설치 확인

Android Studio 실행
우측 상단 More Actions > SDK Manager 클릭
SDK Platforms 탭에서 설치:
- ✅ Android 14.0 (API Level 34)
- ✅ Android 13.0 (API Level 33)
SDK Tools 탭에서 설치:
- ✅ Android SDK Build-Tools 34
- ✅ Android SDK Command-line Tools
- ✅ Android SDK Platform-Tools
- ✅ Android Emulator
- ✅ Google Play services
Apply 클릭하여 설치

3단계: 환경 변수 설정

Windows 10/11

시작 메뉴에서 "환경 변수" 검색
시스템 환경 변수 편집 클릭
환경 변수 버튼 클릭

시스템 변수 추가

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을 새로 열고 다음 명령어 실행:

# Android SDK 확인
$env:ANDROID_HOME

# adb 명령어 확인
adb version

# Java 확인
java -version

모두 정상적으로 출력되면 성공!

방법 2: 명령줄 도구만 설치 (경량)

Android Studio 없이 SDK만 설치하는 방법입니다.

1단계: JDK 설치

다운로드: https://adoptium.net/
JDK 11 (LTS) 선택
설치 시 "Add to PATH" 옵션 체크

2단계: Android Command Line Tools 다운로드

https://developer.android.com/studio#command-tools 접속
Command line tools only 섹션에서 Windows 버전 다운로드
압축 해제

3단계: SDK 설치

# 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을 관리자 권한으로 실행 후:

# 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을 새로 열고 다음 명령어들이 모두 작동하는지 확인:

# 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를 찾을 수 없습니다"

PowerShell을 완전히 종료 후 재시작
환경 변수가 제대로 설정되었는지 확인
컴퓨터 재시작

"JAVA_HOME이 설정되지 않았습니다"

JDK 11 설치: https://adoptium.net/
JAVA_HOME 환경 변수 설정
PowerShell 재시작

SDK Manager 오류

# SDK 라이선스 동의
cd "$env:ANDROID_HOME\cmdline-tools\latest\bin"
.\sdkmanager.bat --licenses
# 모든 라이선스에 'y' 입력

다음 단계

환경 설정이 완료되면:

# 프로젝트 디렉토리로 이동
cd D:\workspace_dtgapk

# Debug APK 빌드 (테스트용)
.\build-debug-apk.bat

# 또는 Release APK 빌드 (배포용)
.\build-apk.bat

5.4 KiB Raw Permalink Blame History