Android 애플리케이션에 MobileFirst Foundation SDK 추가

개요

IBM Mobile Foundation SDK는 Maven Central을 통해 사용 가능한 종속 항목 콜렉션으로 구성되며, Android Studio 프로젝트에 추가될 수 있습니다. 종속 항목은 핵심 기능 및 다른 기능에 해당됩니다.

IBMMobileFirstPlatformFoundation - 클라이언트 대 서버 연결을 구현하고 인증 및 보안 측면, 자원 요청과 기타 필수 핵심 기능을 처리합니다.
IBMMobileFirstPlatformFoundationJSONStore - JSONStore 프레임워크를 포함합니다. 자세한 정보는 Andoid용 JSONStore 학습서를 검토하십시오.
IBMMobileFirstPlatformFoundationPush - 푸시 알림 프레임워크를 포함합니다. 자세한 정보는 알림 학습서를 검토하십시오.

이 학습서에서는 Gradle을 사용하여 신규 또는 기존 Android 애플리케이션에 MobileFirst 네이티브 SDK를 추가하는 방법에 대해 학습합니다. 또한 애플리케이션을 인식하도록 MobileFirst Server를 구성하는 방법 및 프로젝트에 추가되는 MobileFirst 구성 파일에 대한 정보를 찾는 방법에 대해서도 학습합니다.

전제조건:

개발자 워크스테이션에 Android Studio 및 MobileFirst CLI가 설치되어 있습니다.
MobileFirst Server의 로컬 또는 원격 인스턴스가 실행 중입니다.
MobileFirst 개발 환경 설정 및 Android 개발 환경 설정 학습서를 읽으십시오.

MobileFirst 네이티브 SDK 추가

아래 지시사항에 따라 신규 또는 기존 Android Studio 프로젝트에 MobileFirst 네이티브 SDK를 추가하고 MobileFirst Server 인스턴스에 애플리케이션을 등록하십시오.

시작하기 전에 MobileFirst Server가 실행 중인지 확인하십시오.
로컬로 설치된 서버를 사용하는 경우: 명령행 창에서 서버의 폴더로 이동하고 ./run.sh(Mac 또는 Linux OS에서)나 run.cmd(Windows에서) 명령을 실행하십시오.

Android 애플리케이션 작성

Android Studio 프로젝트를 작성하거나 기존 항목을 사용하십시오.

SDK 추가

Android → Gradle 스크립트에서 build.gradle(모듈: 앱) 파일을 선택하십시오.
apply plugin: 'com.android.application' 뒤에 다음 행을 추가하십시오.
```
repositories{
     jcenter()
}
```

android 섹션 내에 다음 행을 추가하십시오.

packagingOptions {
     pickFirst 'META-INF/ASL2.0'
     pickFirst 'META-INF/LICENSE'
     pickFirst 'META-INF/NOTICE'
}

dependencies 섹션 내에 다음 행을 추가하십시오.
```
implementation group: 'com.ibm.mobile.foundation',
name: 'ibmmobilefirstplatformfoundation',
version: '8.0.+',
ext: 'aar',
transitive: true
```
또는 단일 행의 경우:
```
implementation 'com.ibm.mobile.foundation:ibmmobilefirstplatformfoundation:8.0.+'
```
참고: Google Dynamic Delivery 기능을 사용 중이고 기능 모드에서 MobileFirst API를 호출하려는 경우 implementation 대신 api 선언을 사용하십시오. api를 사용하면 기능 모듈을 포함한 앱에 있는 모든 모듈에서 MobileFirst API가 사용 가능하도록 하는 반면 implementation을 사용하면 동일한 모듈 자체에서 MobileFirst API 사용을 제한합니다. 세부사항은 API 및 구현 분리를 읽으십시오.

   api 'com.ibm.mobile.foundation:ibmmobilefirstplatformfoundation:8.0.+'

Android → 앱 → Manifest에서 AndroidManifest.xml 파일을 여십시오. 애플리케이션 요소 위에 다음 권한을 추가하십시오.
```
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
```
기존 활동 요소 옆에 MobileFirst UI 활동을 추가하십시오.
```
<activity android:name="com.worklight.wlclient.ui.UIActivity" />
```

Gradle 동기화 요청이 표시되면 허용하십시오.

MobileFirst 네이티브 SDK를 수동으로 추가

MobileFirst SDK를 다음과 같이 수동으로 추가할 수도 있습니다.

지시사항을 보려면 클릭

MobileFirst SDK를 수동으로 추가하려면 먼저 MobileFirst Operations Console → 다운로드 센터 → SDK 탭에서 SDK .zip 파일을 다운로드하십시오. 위 단계를 완료한 후에 아래 단계도 수행하십시오.

다운로드된 .zip 파일을 추출하고 관련 aar 파일을 app\libs 폴더에 저장하십시오.

다음을 종속 클로저에 추가하십시오.

compile(name:'ibmmobilefirstplatformfoundation', ext:'aar')
compile 'com.squareup.okhttp3:okhttp-urlconnection:3.4.1'   
compile 'com.squareup.okhttp3:okhttp:3.4.1'

다음을 저장소 클로저에 추가하십시오.

repositories {
    flatDir {
        dirs 'libs'
    }
}

닫기 섹션

애플리케이션 등록

명령행 창을 열고 Android Studio 프로젝트의 루트로 이동하십시오.
다음 명령을 실행하십시오.
```
 mfpdev app register
```
- 원격 서버를 사용하는 경우 mfpdev server add 명령을 사용하여 이를 추가하십시오.

mfpdev app register CLI 명령은 먼저 MobileFirst Server에 연결하여 애플리케이션을 등록한 후에 Android Studio 프로젝트의 [project root]/app/src/main/assets/ 폴더에 mfpclient.properties 파일을 생성하고 MobileFirst Server를 식별하는 메타데이터에 추가합니다.

팁: MobileFirst Operations Console에서 애플리케이션을 등록할 수도 있습니다.

MobileFirst Operations Console을 로드하십시오.

애플리케이션 옆에 있는 새로 작성 단추를 클릭하여 새 애플리케이션을 등록하고 화면의 지시사항에 따르십시오.

애플리케이션이 등록된 후에 애플리케이션의 구성 파일 탭으로 이동하고 mfpclient.properties 파일을 복사하거나 다운로드하십시오. 화면의 지시사항에 따라 프로젝트에 파일을 추가하십시오.

WLClient 인스턴스 작성

MobileFirst API를 사용하기 전에 WLClient 인스턴스를 다음과 같이 작성하십시오.

WLClient.createInstance(this);

참고: WLClient 인스턴스는 전체 애플리케이션 라이프사이클 중에 한 번만 작성해야 합니다. Android 애플리케이션 클래스를 사용하여 수행할 것을 권장합니다.

MobileFirst 네이티브 SDK 업데이트

최신 릴리스로 MobileFirst 네이티브 SDK를 업데이트하려면 릴리스 버전 번호를 찾고 build.gradle 파일에서 version 특성을 적절하게 업데이트하십시오.
위의 4단계를 참조하십시오.

SDK 릴리스는 SDK의 JCenter 저장소에 있습니다.

생성되는 MobileFirst 네이티브 SDK 아티팩트

mfpclient.properties

이 파일은 Android Studio 프로젝트의 ./app/src/main/assets/ 폴더에 있으며, MobileFirst Server에서 Android 앱을 등록하는 데 사용되는 클라이언트 측 특성을 정의합니다.

특성	설명	예제 값
wlServerProtocol	MobileFirst Server에 사용되는 통신 프로토콜입니다.	HTTP 또는 HTTPS
wlServerHost	MobileFirst Server의 호스트 이름입니다.	192.168.1.63
wlServerPort	MobileFirst Server의 포트입니다.	9080
wlServerContext	MobileFirst Server에서 애플리케이션의 컨텍스트 루트 경로입니다.	/mfp/
languagePreferences	클라이언트 SDK 시스템 메시지의 기본 언어를 설정합니다.	en

Javadoc 및 Android 서비스의 지원

Javadoc 및 Android 서비스의 지원에 대한 정보는 추가 정보 페이지를 참조하십시오.

다음 학습서

이제 MobileFirst 네이티브 SDK가 통합되었으므로 다음을 수행할 수 있습니다.

▲

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.

Last modified on May 13, 2020