--- title: 소스 코드 포함 Android Back4App 통합 가이드 slug: docs-kr/android/android-project-with-source-code-download description: 소스 코드 Android 프로젝트 다운로드 및 Back4App 통합 방법 안내입니다. image: https://www.back4app.com/images/logo-social.png createdAt: 2024-03-12T20:45:23.355Z --- # 소스 코드가 포함된 Android 프로젝트 다운로드 및 Back4App 사용 시작하기 ## 소개 이 가이드에서는 Java 또는 Kotlin으로 작성된 Android 애플리케이션을 시작하고 이를 Back4App에 연결하는 방법을 배웁니다. 자세한 빠른 시작 가이드가 필요하거나 Back4App을 기존 프로젝트에 연결하려면 다음으로 이동하세요 [Parse SDK 설치 튜토리얼](https://www.back4app.com/docs/android/parse-android-sdk) ## 목표 Android 템플릿 다운로드 및 Back4App에 연결하기 ## 전제 조건 :::hint{type="info"} - [Android Studio 버전 4.1 이상](https://developer.android.com/studio/index.html) - Back4App에서 생성된 앱. - 다음 [새 Parse 앱 튜토리얼](https://www.back4app.com/docs/get-started/new-parse-app)을 따라 Back4App에서 Parse 앱을 만드는 방법을 배우세요. ::: ## 1 - 템플릿 다운로드 Java로 작성된 템플릿과 Kotlin으로 작성된 템플릿, 총 2개의 Android 템플릿이 있습니다: - [코틀린 예제 저장소](https://github.com/templates-back4app/android-kotlin-starter-template) - [자바 예제 저장소](https://github.com/templates-back4app/android-java-starter-template) 당신에게 맞는 템플릿을 선택하고, Android Studio에서 프로젝트를 다운로드하거나 가져오세요. ### 1.1 - GitHub에서 직접 다운로드 다음 명령어를 사용하여 프로젝트 템플릿을 다운로드하고 압축을 푸세요: ::::ExpandableHeading **MacOS 및 Linux** :::CodeblockTabs ```java $ curl -LOk https://github.com/templates-back4app/android-java-starter-template/archive/master.zip && unzip master.zip ``` ```kotlin $ curl -LOk https://github.com/templates-back4app/android-kotlin-starter-template/archive/master.zip && unzip master.zip ``` ::: :::: :::ExpandableHeading **Windows** ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/rwKky1GhnCrMeLd1Fqv_h_image.png) ::: ### 1.2 - Android Studio에서 프로젝트 열기 파일을 다운로드한 후, 압축을 푸세요. Android Studio를 열어봅시다. Android Studio의 환영 화면에서 **‘기존 프로젝트 열기’**를 선택하고 프로젝트 폴더를 선택하세요. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/YTGfM9yPvulBzq16XurNv_image.png) 다운로드하고 압축을 푼 폴더의 위치를 선택하고 엽니다. Gradle 실행 프로세스가 끝날 때까지 기다려 주십시오. 이제 Android Studio에서 Gradle 콘솔 하단 탭을 볼 수 있습니다. ### 1.3 - GitHub에서 가져오기(선택적 경로) 저장소 링크를 Android Studio에 직접 가져올 수 있습니다. Android Studio 환영 화면에서 **‘버전 관리에서 가져오기’** ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/9-PUyUTdaJPyxMaQ8YhKD_image.png) Android Studio는 Git 저장소 링크와 원하는 프로젝트 경로를 요청합니다. 이 섹션의 시작 부분에서 저장소 링크를 찾을 수 있습니다. 이 섹션의 시작 부분에서 저장소 링크를 찾을 수 있습니다. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/Hzljs-WMmNnIWQQjAsofd_image.png) URL 및 디렉토리 필드를 입력한 후, **복제** 버튼을 클릭합니다. 그러면 Android Studio가 프로젝트를 복사하고 엽니다. Gradle 실행 프로세스가 끝날 때까지 기다려 주십시오. 이제 Android Studio에서 Gradle 콘솔 하단 탭을 볼 수 있습니다. Android Studio가 프로젝트를 복사하고 엽니다. Gradle 실행이 완료될 때까지 기다려 주십시오. Android Studio에서 Gradle 콘솔 하단 탭을 확인할 수 있습니다. ## 2 - 앱 키 가져오기 이 가이드에서는 프로젝트에서 다음 파일을 사용합니다 : `AndroidManifest.xml` - Back4App 자격 증명을 설정합니다 `` 및 앱 권한 `App.java` (`App.kt` 코틀린용) - 여기에서 초기화 코드를 수정합니다 `MainActivity.java` (`MainActivity.kt` 코틀린용) - Parse 객체를 생성하기 위한 첫 번째 코드를 포함합니다 `strings.xml` - 여기에서 Back4App 설정 자격 증명을 저장하고 읽습니다 `build.gradle` - 여기에서 Parse Android SDK 버전을 설정합니다 앱 프로젝트를 Back4App 서버에 연결하려면 서버 URL, 애플리케이션 ID 및 클라이언트 키라는 세 가지 주요 정보가 필요합니다. Android 프로젝트에서 strings.xml은 이 정보를 설정하기에 완벽한 장소입니다. Parse Android SDK가 Back4App 앱과 연결하기 위해 애플리케이션 키 값을 읽는 곳입니다. 서버 URL은 이미 프로젝트에 있습니다. 이제 Back4App으로 가서 앱 키를 복사하고 해당 값으로 strings.xml을 업데이트해야 합니다: 1. strings 파일을 엽니다: `.../app/src/main/res/values/strings.xml` ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/KJ-smC7t6unznvL7h0gsv_image.png) 2\. 앱 대시보드로 이동합니다 [Back4App 웹사이트.](https://www.back4app.com/) 3\. 다음에서 키를 찾습니다: `앱 설정` > `보안 및 키`. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/5mOgO_acno_d2_SrvkCQH_image.png) 4\. 당신의 `strings.xml` 파일로 돌아가서 `applicationId` 과 `clientKey`을 붙여넣으세요. ```xml 1 2 Back4AppExample 3 https://parseapi.back4app.com/ 4 5 6 PASTE_YOUR_APPLICATION_ID_HERE 7 PASTE_YOUR_CLIENT_KEY_HERE 8 ``` 5\. 프로젝트 탐색기에서 Gradle 스크립트의 build.gradle (Module\:Back4AppExample.app) 파일을 엽니다. ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/nMxeKFNVGzA9mivKlP4wU_image.png) `dependencies` 섹션에서 Parse-SDK-Android 값을 원하는 버전으로 변경하세요. ```java implementation "com.github.parse-community.Parse-SDK-Android:parse:latest-version-here" ``` 저장한 후 `build.gradle`을 실행하고 ‘지금 동기화’ 하세요. :::hint{type="info"} 현재 SDK 버전은 여기에서 확인할 수 있습니다 [SDK Versions](https://jitpack.io/#parse-community/Parse-SDK-Android). ::: ## 3 - Back4App에 연결하기 앱 자격 증명을 설정한 후, Back4App에서 Parse Server 인스턴스와 연결할 준비가 되었습니다. 사용할 초기화 코드입니다: 프로젝트에서 초기화 코드를 찾을 수 있습니다 `App.java` (`App.kt` 코틀린용) 우리는 초기화를 위해 `App.java`를 사용하고 있습니다. 앱이 다른 작업을 수행하기 전에 연결을 설정해야 하기 때문입니다. `App.java`는 다른 Activity와 Service가 생성되기 전에 생성되는 첫 번째 Context이며, 마지막으로 파괴됩니다. 아래 초기화 코드는 `strings.xml`에서 앱 키를 가져오고 Back4App 서버와의 연결을 시도합니다. 우리는 다른 작업을 수행하기 전에 서버에 먼저 연결하고 싶기 때문에 onCreate() 메서드에 코드를 넣습니다. :::CodeblockTabs App.java ```java 1 public class App extends Application { 2 @Override 3 public void onCreate() { 4 super.onCreate(); 5 Parse.initialize(new Parse.Configuration.Builder(this) 6 .applicationId(getString(R.string.back4app_app_id)) 7 .clientKey(getString(R.string.back4app_client_key)) 8 .server(getString(R.string.back4app_server_url)) 9 .build()); 10 } 11 } ``` App.kt ```kotlin 1 class App : Application() { 2 override fun onCreate() { 3 super.onCreate() 4 Parse.initialize( 5 Parse.Configuration.Builder(this) 6 .applicationId(getString(R.string.back4app_app_id)) 7 .clientKey(getString(R.string.back4app_client_key)) 8 .server(getString(R.string.back4app_server_url)) 9 .build()); 10 } 11 } ``` ::: 이제 서버와 상호작용하기 위한 코드를 추가할 시간입니다. MainActivity 파일을 열어봅시다. Activity 파일은 사용자와 상호작용하는 데 훌륭합니다. 그들의 주요 목적은 사용자 인터페이스를 제공하는 것입니다. 시작 시 어떤 Activity를 표시할지 선택할 수 있습니다 `AndroidManifest.xml` ```xml 1 2 3 4 5 6 ``` 우리 프로젝트에서 MainActivity는 시작 시 열리도록 설정되어 있습니다. 이 코드 샘플에서는 Parse SDK 코드를 사용하여 Parse 객체를 서버에 저장하고 저장된 Parse 객체의 objectId를 사용자에게 TextView로 보여줍니다. :::CodeblockTabs MainActivity.java ```java 1 public class MainActivity extends AppCompatActivity { 2 @Override 3 protected void onCreate(Bundle savedInstanceState) { 4 super.onCreate(savedInstanceState); 5 setContentView(R.layout.activity_main); 6 TextView textView = findViewById(R.id.textView); 7 ParseObject firstObject = new ParseObject("FirstClass"); 8 firstObject.put("message","Hey ! First message from android. Parse is now connected"); 9 firstObject.saveInBackground(e -> { 10 if (e != null){ 11 Log.e("MainActivity", e.getLocalizedMessage()); 12 }else{ 13 Log.d("MainActivity","Object saved."); 14 textView.setText(String.format("Object saved. %s", firstObject.getObjectId())); 15 } 16 }); 17 } 18 } ``` MainActivity.kt ```kotlin 1 class MainActivity : AppCompatActivity() { 2 override fun onCreate(savedInstanceState: Bundle?) { 3 super.onCreate(savedInstanceState) 4 setContentView(R.layout.activity_main) 5 val textView = findViewById(R.id.textView) 6 val firstObject = ParseObject("FirstClass") 7 firstObject.put("message","Hey ! First message from android. Parse is now connected") 8 firstObject.saveInBackground { 9 if (it != null){ 10 it.localizedMessage?.let { message -> Log.e("MainActivity", message) } 11 }else{ 12 Log.d("MainActivity","Object saved.") 13 textView.text = String.format("Object saved. %s", firstObject.objectId) 14 } 15 } 16 } 17 } ``` ::: ## 4 - 연결 테스트 1. 장치 또는 가상 장치에서 앱을 빌드하세요 (`Shift`+`F10`). ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/PWVvmanCmRcSYI9Ui3GO0_image.png) :::hint{type="info"} 앱을 실행할 가상 장치가 없다면, Android Studio의 AVD Manager에서 새로 만들 수 있습니다. ::: 1. “`Hello Word!` ” 화면이 나타날 때까지 기다리세요. “`Hello Word!`” 이후에 `객체가 저장되었습니다`. 이 메시지에는 저장된 객체의 ID가 포함됩니다. ::Image[]{src="https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/oGS_6wcZQJ-oLzJpxj54v_image.png" size="50" width="340" height="726" position="center" showCaption="false"} 2\. [Back4App 웹사이트](https://www.back4app.com/). 3\. 앱을 찾아서 `대시보드` > `데이터베이스` > `브라우저`. 모든 것이 제대로 작동하면, 다음과 같이 `FirstClass` 라는 클래스를 찾을 수 있어야 합니다: ![](https://api.archbee.com/api/optimize/yD3zCY-NNBBIfd0uqcfR5/QYDpDyCwN9GNk-7HxLQFG_image.png) ## 완료되었습니다! 대시보드에서 objectId를 확인할 수 있으며, 앱 화면이 일치합니다! 이 시점에서, Android 앱을 시작하는 방법을 배웠습니다. :::hint{type="success"} 우리의 [Android 튜토리얼 ](https://www.back4app.com/docs/android/android-project-with-source-code-download)을 통해 더 알아보거나 [Parse 오픈 소스 문서(Android SDK용)](http://docs.parseplatform.org/android/guide/) :::