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

improve this page | report issue

개요

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

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

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

전제조건:

다음으로 이동:

MobileFirst 고유 SDK 추가

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

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

Android 애플리케이션 작성

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

SDK 추가

  1. Android → Gradle 스크립트에서 build.gradle(모듈: 앱) 파일을 선택하십시오.

  2. apply plugin: 'com.android.application' 뒤에 다음 행을 추가하십시오.

    repositories{
         jcenter()
    }
    
  3. android 섹션 내에 다음 행을 추가하십시오.

    packagingOptions {
         pickFirst 'META-INF/ASL2.0'
         pickFirst 'META-INF/LICENSE'
         pickFirst 'META-INF/NOTICE'
    }
    
  4. dependencies 섹션 내에 다음 행을 추가하십시오.

    compile group: 'com.ibm.mobile.foundation',
    name: 'ibmmobilefirstplatformfoundation',
    version: '8.0.+',
    ext: 'aar',
    transitive: true
    

    또는 단일 행의 경우:

    compile 'com.ibm.mobile.foundation:ibmmobilefirstplatformfoundation:8.0.+'
    
  5. Android → 앱 → Manifest에서 AndroidManifest.xml 파일을 여십시오. 애플리케이션 요소 위에 다음 권한을 추가하십시오.

    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    
  6. 기존 활동 요소 옆에 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'
        }
    }

애플리케이션 등록

  1. 명령행 창을 열고 Android Studio 프로젝트의 루트로 이동하십시오.

  2. 다음 명령을 실행하십시오.

     mfpdev app register
    

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

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

  1. MobileFirst Operations Console을 로드하십시오.
  2. 애플리케이션 옆에 있는 새로 작성 단추를 클릭하여 새 애플리케이션을 등록하고 화면의 지시사항에 따르십시오.
  3. 애플리케이션이 등록된 후에 애플리케이션의 구성 파일 탭으로 이동하고 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가 통합되었으므로 다음을 수행할 수 있습니다.

Last modified on November 17, 2017