> For the complete documentation index, see [llms.txt](https://kookmoban.gitbook.io/osam/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kookmoban.gitbook.io/osam/how-to-build/test.md).

# APP

## 설치 안내 (Installation Process)

## Terminal을 이용하는 방법

{% hint style="info" %}
Java, JDK 설치가 필요합니다.
{% endhint %}

### **프로젝트 다운로드**

```
$ git clone https://github.com/osamhack2020/APP_KookMoBanUser_PonJohmNaimann.git
$ cd APP_KookMoBanUser_PonJohmNaimann
```

### **디버그 APK 빌드**

```
$ ./gradlew assembleDebug
```

위 명령을 실행하면 *project\_name/module\_name/build/outputs/apk* 에 *module\_name-debug.apk* 라는 APK 파일이 만들어진다. 이 파일은 이미 디버그 키로 서명되고 zipalign으로 정렬되어 있으므로 기기에 바로 설치할 수 있다.

### **디버그 APK 파일을 실행중인 애뮬레이터나 연결된 기기에 즉시 설치**

```
$ sudo chmod +x ./gradlew
$ ./gradlew installDebug
```

### **애뮬레이터에 출시 APK 배포**

터미널에서 *android\_sdk/tools/* 로 이동하고 AVD를 지정하여 애뮬레이터를 시작한다.

```
$ emulator -avd avd_name
```

```
$ adb install path/to/your_app.apk
```

명령어를 실행하면 *project\_name/module\_name/build/outputs/apk/* 에 APK파일이 저장된다.

### **실제 기기에 출시 APK 배포**

```
$ adb -d install path/to/your_app.apk
```

명령어를 실행하면 *project\_name/module\_name/build/outputs/apk/* 에 APK파일이 저장된다.

## Android Studio IDE를 이용하는 방법

### Github Project Clone

1. *File > New > Project From Version Control...*
2. URL에 [*https://github.com/osamhack2020/APP\_KookMoBanUser\_PonJohmNaimann.git*](https://github.com/osamhack2020/APP_KookMoBanUser_PonJohmNaimann.git)

   을 입력한다.

![](https://2653380560-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MKdTwUS64F4uZsg5UX2%2F-MKwqIZ2vqqKTF6rd37N%2F-MKwqbHTsUi4yO2WWqlC%2Fimage.png?alt=media\&token=ab96e416-e694-4994-b4a4-f20a11cf949a)

### APK 파일 빌드 프로세스

1. *Build > Generate Signed Bundle/APK ...*
2. APK 를 선택한다.
3. Key Store 정보와 Key Password를 입력한다.
4. Build Variants는 ***release***로, Signature Versions은 **V1(Jar Signature)**과 ***V2(Full APK Signature)***를 모두 선택해준다.

![](https://2653380560-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MKdTwUS64F4uZsg5UX2%2F-MKwMsogpNZg7gtkvU_K%2F-MKwXVZTVtdqkUte5eg1%2Fimage.png?alt=media\&token=7d4a3fb0-4e06-4463-9610-735a6bc8dcfb)

![](https://2653380560-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MKdTwUS64F4uZsg5UX2%2F-MKwMsogpNZg7gtkvU_K%2F-MKwXjBUVVghax2Yp0DX%2Fimage.png?alt=media\&token=d652ce68-3d4d-4cbf-aff5-1284dd19af98)

![](https://2653380560-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MKdTwUS64F4uZsg5UX2%2F-MKwMsogpNZg7gtkvU_K%2F-MKwXyA6RWDzFrZdlqaD%2Fimage.png?alt=media\&token=5892ab02-5697-488f-930c-ccff4ca78f4a)