이 페이지에서는 기존의 Android Cloud Endpoints 버전 1.0 앱을 App Engine용 Endpoints Frameworks로 이전하는 방법을 설명합니다. 이 페이지에서는 Endpoints 버전 1.0을 Endpoints Frameworks 버전 1.0으로, 새로운 App Engine용 Endpoints Frameworks를 Endpoints Frameworks 버전 2.0으로 지칭합니다.
이점
새로운 프레임워크에는 다음과 같은 여러 가지 장점이 있습니다.
- 요청 지연 시간 감소
- App Engine 기능(예: 커스텀 도메인)과의 통합 향상
- Guice 구성 공식 지원
- 새로운 API 관리 기능(선택사항)
Endpoints Frameworks 버전 2.0은 API에 대한 인터페이스에 영향을 주지 않습니다. 기존 클라이언트는 이전 후에도 클라이언트 측 코드 변경 없이 계속 작동합니다.
Endpoints Frameworks 버전 2.0으로 Android 멀티 모듈 프로젝트 이전
다음 단계에서는 Android 스튜디오 Endpoints Frameworks 버전 1.0 프로젝트를 Endpoints Frameworks 버전 2.0으로 이전하는 과정을 안내합니다. 가이드에서는 Endpoints 모듈이 있는 Android 스튜디오 프로젝트를 이전합니다.
작업 목록
마이그레이션 가이드를 진행할 때 아래의 개략적인 태스크 목록을 사용합니다. 이 마이그레이션 가이드에서는 Google Cloud 모듈을 사용하는 기존 Android 프로젝트가 있다고 가정합니다.
- 시작하기 전에
- Google Cloud CLI 설정
- 샘플 코드 다운로드(선택사항)
- Endpoints Frameworks 버전2.0으로 이전
- 백엔드 모듈 배포
- 클라이언트 라이브러리 생성
시작하기 전에
- Android 스튜디오를 설치합니다.
- Android SDK 26+를 설치합니다.
- gcloud CLI 설치
gcloud CLI 설정
gcloud CLI를 설정하려면 다음 안내를 따르세요.
gcloud CLI를 초기화합니다.
gcloud init
애플리케이션 기본 사용자 인증 정보를 사용합니다.
gcloud auth application-default login
app-engine-java
구성요소를 설치합니다.gcloud components install app-engine-java
샘플 코드 다운로드(선택사항)
GitHub에서 legacy
및 v2
샘플 프로젝트를 클론하려면 다음 안내를 따르세요.
샘플 저장소를 로컬 머신에 클론합니다.
git clone https://github.com/GoogleCloudPlatform/android-docs-samples
legacy
및v2
의 샘플 코드가 있는 디렉터리로 변경합니다.cd android-docs-samples/endpoints-frameworks/
Endpoints 프레임워크 버전 2.0으로 마이그레이션
build.gradle
파일을 업데이트합니다.
Endpoints Framework 버전 2.0 종속 항목은 Guava 19를 사용하고 Android Gradle 빌드 플러그인 com.android.tools.build:gradle:2.3.3
은 Guava 18을 사용합니다. build.gradle
의 빌드 스크립트 종속 항목 클로저에 Guava 19를 추가하여 이 임시 종속 항목을 재정의합니다.
기존
v2
app/build.gradle
파일 업데이트
Endpoints 버전 1.0에서는 Gradle 플러그인(gradle-appengine-plugin
)을 사용하여 API 검색 문서를 생성했습니다. Endpoints Frameworks 버전 2.0에서는 endpoints-framework-gradle-plugin
을 사용하여 검색 문서를 생성합니다.
이 빌드 스크립트에서는 클라이언트 측 플러그인(com.google.cloud.tools.endpoints-framework-client
)을 사용합니다.
기존
v2
backend/build.gradle
파일 업데이트
App Engine 표준 환경 Gradle 도구가 업데이트되었습니다.
Endpoints Framework 버전 1.0 프로젝트는 com.google.appengine
의 gradle-appengine-plugin
을 사용했지만 Endpoints Framework 버전 2.0 프로젝트는 appengine-gradle-plugin
을 사용합니다.
이 빌드 스크립트에서는 서버 측 플러그인(com.google.cloud.tools.endpoints-framework-server
)을 사용합니다.
기존
v2
web.xml
파일 업데이트
Endpoints Frameworks 버전 2.0에서는 서블릿 클래스가 SystemServiceServlet
에서 EndpointsServlet
으로 변경되었습니다.
URL 패턴은 /_ah/spi/*
에서 /_ah/api/*
로 업데이트되었습니다.
기존
v2
프로젝트 다시 빌드
마지막으로, Android 스튜디오 빌드 목록을 사용하여 Android 스튜디오 프로젝트를 정리하고 새 종속 항목으로 다시 빌드합니다.
백엔드 모듈 배포
이제 backend
모듈에서 다음 Gradle 태스크를 사용하여 새 Gradle App Engine 플러그인을 통해 백엔드 모듈을 배포합니다.
gradle appengineDeploy
클라이언트 라이브러리 생성
클라이언트 라이브러리를 생성하려면 backend
모듈에서 다음 Gradle 태스크를 사용합니다.
gradle endpointsClientLibs
Endpoints Frameworks Gradle 플러그인에 사용 가능한 작업에 대해 자세히 알아보세요.
Endpoints API 관리 추가
Endpoints Frameworks 버전 2.0에서는 다음을 비롯한 API 관리 기능도 사용할 수 있습니다.
- API 키 관리
- API 공유
- 사용자 인증
- API 측정항목
- API 로그
이러한 기능과 기타 Cloud Endpoints 프레임워크 2.0 기능을 사용하려면 App Engine용 Endpoints 프레임워크에 대한 자바 페이지를 참조하세요.