[Setup][WSL][Android Studio] WSL2 Ubuntu 24.04 안드로이드 스튜디오 네이티브 세팅 가이드

이 글은 WSL에 안드로이드 스튜디오 개발 환경을 세팅하는 방법에 대해 정리한 글입니다.

WSL에서 안드로이드 스튜디오를 설치하고 GUI 환경을 불러와 개발할 수 있는 환경을 세팅합니다.

---

필수 패키지 및 라이브러리 설치

아래 명령어를 통해 먼저 저장소 업데이트와 기존 패키지 업그레이드를 진행한다.

sudo apt update
sudo apt upgrade -y

이후 필요한 패키지를 모두 설치한다.

sudo apt install -y openjdk-17-jdk wget unzip zip cmake ninja-build build-essential \
libnss3 libatk1.0-0t64 libatk-bridge2.0-0t64 libcups2t64 libdrm2 libxkbcommon0 \
libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2t64 libpango-1.0-0 \
libpangocairo-1.0-0 libxshmfence1 libpulse0 libvulkan1 libgl1 \
libxi6 libxcursor1 libxtst6

---

안드로이드 스튜디오 다운로드 및 압축 해제

터미널에서 바로 홈 디렉토리로 이동 후, wget을 이용하여 안드로이드 스튜디오를 다운 받아 설치한다.

cd ~
wget "https://edgedl.me.gvt1.com/android/studio/ide-zips/2025.3.1.8/android-studio-panda1-patch1-linux.tar.gz" -O android-studio-latest.tar.gz

안드로이드 스튜디오의 새로운 버전이 올라오면 해당 링크가 변경된다. 만약 새로운 버전이 출시되었다면, 안드로이드 스튜디오 공식 사이트에서 Linux 버전의 파일 링크를 복사해서 위 링크 대신에 넣으면 된다.

https://developer.android.com/studio?hl=ko

Android 스튜디오 및 앱 도구 다운로드 - Android 개발자  |  Android Studio  |  Android Developers

안드로이드 스튜디오 공식 사이트

다운로드가 완료되면, 아래 명령어로 압축을 해제하고, 다운로드한 압축 파일은 삭제한다.

tar -zxvf android-studio-latest.tar.gz
rm android-studio-latest.tar.gz

---

터미널 환경 변수 및 단축어 설정

SDK 및 Java 경로, 그리고 안드로이드 스튜디오를 편하게 실행할 수 있도록 단축어까지 설정한다.

Shell 설정 파일(ex. .bashrc 혹은 .zshrc)을 열어준다.

vim ~/.bashrc

# zsh를 사용하는 경우에는
vim ~/.zshrc

설정 파일 맨 아래에 아래 내용을 그대로 복사해서 넣는다.

# ==========================================
# Android Studio & SDK Environment Variables
# ==========================================
# 1. Java 17 경로
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$PATH:$JAVA_HOME/bin

# 2. Android SDK 경로 (소문자 android-sdk)
export ANDROID_HOME=$HOME/android-sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin

# 3. 안드로이드 스튜디오 실행 단축어
alias as='~/android-studio/bin/studio.sh &'

편집이 완료되면, 저장 후 종료한다. 그리고 설정을 적용한다.

source ~/.bashrc

# zsh를 사용하는 경우
source ~/.zshrc

---

KVM(에뮬레이터 가속) 권한 부여 및 시스템 재시작

에뮬레이터 실행을 위한 설정을 진행한다.

먼저 현재 사용자에게 하드웨어 가속 권한을 부여한다.

sudo usermod -aG kvm,render $USER

이후 WSL을 완전히 종료한 후, 다시 실행한다.

# WSL 터미널
sudo --shutdown

# PowerShell
wsl --shutdown

---

안드로이드 스튜디오 초기 셋업

다시 WSL 터미널을 열어서 안드로이드 스튜디오를 켠다. 만약 별칭을 다른 걸로 지정했으면, 해당 별칭을 이용하여 실행한다.

as

정상적으로 설치되었으면 아래와 같이 창이 뜬다. (창 디자인을 확인하면 윈도우가 아닌 Linux의 GUI로 열린 것을 알 수 있다.)

안드로이드 스튜디오 초기 세팅

화면에 나오는 내용을 따라 초기 세팅을 진행한다.

초기 세팅 진행 및 다운로드

세팅이 완료되면 아래와 같이 프로젝트 시작 화면이 뜬다.

프로젝스 생성 화면

---

프로젝트 생성 테스트

테스트용 프로젝트르 하나 생성하고 Gradle 설치가 정상적으로 이루어지는지, 그리고 에뮬레이터는 정상적으로 실행되는 지 확인한다.

안드로이드 스튜디오

프로젝트가 정상적으로 실행되고, 에뮬레이터 실행까지 정상적으로 되면 성공적으로 세팅이 된 것이다.

이것으로 세팅 끝!!