[0주차].안드로이드 스튜디오 설치 & 개발환경 세팅 가이드

[사전 과제] 안드로이드 스튜디오 설치 & 개발환경 세팅 가이드

앱동 부트캠프를 원활하게 진행하기 위해, 수업까지 반드시 해와야 하는 세팅입니다.
설명이 부정확할수도 있어서 혹시나 막히는 부분은 유튜브나 AI를 참고해 주세요.

1단계: 안드로이드 스튜디오 (Android Studio) 설치

1. 다운로드 링크 에 접속.
2. 다운로드 버튼을 눌러 설치 파일 다운.
3. 다운로드받은 파일을 실행, 계속 눌러 설치 완료.
   • ⚠ 컴퓨터 사용자 이름이나 설치 경로에 한글이 들어가면 에러나기가 쉽습니다
   • 가급적 C드라이브 기본 경로에 그대로 설치하세요.
4. 안드로이드 스튜디오 처음 실행 후 기본 다운로드 시작.

   2단계: 스마트폰 개발자 모드

   우리는 에뮬레이터 대신 본인 스마트폰에 앱을 테스트할 겁니다.
   에뮬레이터가 간단하긴 하지만, 노트북 특성상 렉을 너무 많이 유발합니다.
5. 폰 설정 열기
6. 맨 밑으로 내려서 휴대전화 정보 터치
7. 소프트웨어 정보 터치
8. 중간 쯤에 있는 빌드번호 7번 연속으로 터치
9. 켜졌다는 안내가 뜨면 성공
10. 다시 설정 화면으로 돌아가서 스크롤을 맨 밑에 개발자 옵션 메뉴가 새로 생김.
11. 진입후 중간쯤에 무선 디버깅 항목 켜기

    3단계: 안드로이드 스튜디오랑 폰 연결

12. 안드로이드 스튜디오 우상단 Device Manager 진입
    ![[Pasted image 20260318231845.png]]
13. 상단의 와이파이 기호 클릭 후, Pair Devices Using Wi-Fi 클릭
    (노트북-휴대폰이 같은 와이파이에 연결되어있어야 합니다.)
    ![[Pasted image 20260318232059.png]]
14. 그러면 QR코드가 화면에 나옵니다. (페어링 코드로 할수도있는데 QR이 편한거 같아요)
15. 아까 켜둔 휴대폰 무선 디버깅 클릭 후, QR코드로 기기 페어링 클릭 후 QR 스캔

    웹 애뮬레이터

    노트북도 잘안되고 무선 연결도 잘안되는 상황에서는 웹 클라우드의 애뮬레이터를 이용할수도있습니다.
    ![https://appetize.io/apps]
    위 사이트에 접속하고 로그인 한후 apks파일을 빌드한 후 .apks 파일을 업로드하면 이용가능합니다.

    4단계: 프로젝트 생성 & 파일 구경 (해주시면 감사합니다)

16. 안드로이드 스튜디오 첫 화면에서 New Project 클릭
17. 템플릿 목록이 뜨는데, Empty Activity 선택하고 Next 클릭 (기초 템플릿 같은겁니다)
18. 프로젝트 이름(Name) 칸에 appdong-wordlist 처럼 이름을 적어봅니다.
    • [주의] 아래쪽에 Language가 Kotlin, Build configuration language가 Kotlin DSL (build.gradle.kts) 로 되어 있는지 확인해주세요
19. Run 버튼 눌러보기 상단 ▶ 버튼 눌러서 앱 실행까지 확인

    파일 트리 보는 법

    화면 왼쪽 상단에 있는 폴더 계층 구조(Project 뷰)를 보세요.

• app > kotlin+java > (패키지명) > MainActivity.kt
  • 여기가 코틀린(Kotlin) 코드를 짤 메인 파일입니다(이파일 외에도 여러 파일과 폴더를 만들고 관리 할거에요). 이 안에 화면도 그리고 기능도 넣습니다.
• Gradle Scripts > build.gradle.kts (Module :app)
  • 이건 코딩하는 곳이 아니라, 라이브러리를 가져오는 곳입니다. 인터넷에서 남이 만든 기능을 쓸 때 이 파일 맨 아래 dependencies 블록에 한 줄 적어주고 우상단에 뜨는 Sync Now를 누르면 됩니다.

    에러 대응

    발생할수도 있는 문제

• 기기가 안 잡힘
  와이파이 껐다 켜기 / Android Studio 재실행
• QR코드 스캔했는데 연결 안 됨
  휴대폰에서 무선 디버깅 껐다가 다시 켜기
• Run 눌렀는데 아무 반응 없음
  상단에서 기기 선택이 제대로 되었는지 확인
• Gradle Sync 계속 돌아감
  기다리기 원래 오래걸림
• 실행 시 에러 발생
  Android Studio 재시작 후 다시 시도

  언어에 대해

• 코틀린은 자바기반 언어입니다. 물론 사용하는 여러 함수는 안드로이드꺼지만 기본 뼈대는 Java이니, Java 기본 문법을 조금 알고 오시면 좋습니다. Kotlin도 고유 문법이 있으니 자바를 아시는 분은 Kotlin도 조금 익혀 오시면 편합니다.