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

개요

MobileFirst Foundation SDK는 CocoaPods를 통해 사용 가능하며 Xcode 프로젝트에 추가할 수 있는 POD 콜렉션으로 구성됩니다.
POD는 핵심 기능 및 다른 기능에 해당됩니다.

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

이 학습서에서는 신규 또는 기존 iOS 애플리케이션에 CocoaPods를 사용하여 MobileFirst 네이티브 SDK를 추가하는 방법에 대해 학습합니다. 또한 애플리케이션을 인식하도록 MobileFirst Server를 구성하는 방법도 학습합니다.

전제조건:

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

참고: XCode 8을 사용하여 시뮬레이터에서 iOS 앱을 실행 중인 경우 키 체인 공유 기능은 필수입니다.

다음으로 이동:

• MobileFirst 네이티브 SDK 추가
• MobileFirst 네이티브 SDK를 수동으로 추가
• Apple watchOS에 대한 지원 추가
• MobileFirst 네이티브 SDK 업데이트
• 생성되는 MobileFirst 네이티브 SDK 아티팩트
• 비트 코드 및 TLS 1.2
• 다음 학습서

MobileFirst 네이티브 SDK 추가

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

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

애플리케이션 작성

Xcode 프로젝트를 작성하거나 기존 항목(Swift 또는 Objective-C)을 사용하십시오.

SDK 추가

1. Mobile Foundation 네이티브 SDK는 CocoaPods를 통해 제공됩니다.
   • 개발 환경에 CocoaPods가 이미 설치되어 있는 경우 2단계로 건너뛰십시오.
   • CocoaPods가 설치되지 않은 경우 다음과 같이 설치하십시오.
     • 명령행 창을 열고 Xcode 프로젝트의 루트로 이동하십시오.
     • sudo gem install cocoapods 및 pod setup 명령을 순서대로 실행하십시오. 참고: 이러한 명령을 완료하려면 몇 분 정도 소요될 수 있습니다.
2. pod init 명령을 실행하십시오. Podfile 파일이 작성됩니다.
3. 선호하는 코드 편집기에서 Podfile을 여십시오.
   • 파일 컨텐츠를 주석 처리하거나 삭제하십시오.

   • 다음 행을 추가하고 변경사항을 저장하십시오.

     use_frameworks!
     
     platform :ios, 8.0
     target "Xcode-project-target" do
         pod 'IBMMobileFirstPlatformFoundation'
     end
     

     • Xcode 프로젝트의 대상 이름으로 Xcode-project-target을 대체하십시오.

4. 명령행 창으로 돌아가서 pod install 및 pod update 명령을 순서대로 실행하십시오. 이러한 명령은 Mobile Foundation 네이티브 SDK 파일 및 mfpclient.plist 파일을 추가하고 Pod 프로젝트를 생성합니다.
   참고: 명령을 완료하려면 몇 분 정도 소요될 수 있습니다.

   중요: 여기서부터 [ProjectName].xcworkspace 파일을 사용하여 Xcode에서 프로젝트를 여십시오. [ProjectName].xcodeproj 파일을 사용하지 마십시오. CocoaPods 기반 프로젝트는 애플리케이션(실행 파일) 및 라이브러리(CocoaPod 관리자가 가져오는 모든 프로젝트 종속 항목)를 포함하는 작업공간으로 관리됩니다.

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

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

애플리케이션 등록

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

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

    mfpdev app register
   

   • 원격 서버를 사용하는 경우 mfpdev server add 명령을 사용하여 이를 추가하십시오.

   애플리케이션의 번들 ID를 제공하라는 메시지가 표시됩니다. 중요: 번들 ID는 대소문자를 구분합니다.

mfpdev app register CLI 명령은 먼저 MobileFirst Server에 연결하여 애플리케이션을 등록한 후에 Xcode 프로젝트의 루트에서 mfpclient.plist 파일을 생성하고 MobileFirst Server를 식별하는 메타데이터에 추가합니다.

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

1. MobileFirst Operations Console을 로드하십시오.
2. 애플리케이션 옆에 있는 새로 작성 단추를 클릭하여 새 애플리케이션을 등록하고 화면의 지시사항에 따르십시오.
3. 애플리케이션이 등록된 후에 애플리케이션의 구성 파일 탭으로 이동하고 mfpclient.plist 파일을 복사하거나 다운로드하십시오. 화면의 지시사항에 따라 프로젝트에 파일을 추가하십시오.

설정 프로세스 완료

Xcode에서 프로젝트 항목을 마우스 오른쪽 단추로 클릭하고 [프로젝트 이름]에 파일 추가를 클릭한 다음 Xcode 프로젝트의 루트에 있는 mfpclient.plist 파일을 선택하십시오.

SDK 참조

Mobile Foundation 네이티브 SDK를 사용할 때마다 Mobile Foundation 프레임워크를 가져오십시오.

Objective-C:

#import <IBMMobileFirstPlatformFoundation/IBMMobileFirstPlatformFoundation.h>

Swift:

import IBMMobileFoundationSwift

iOS 9 이상에 대한 참고사항:

Xcode 7부터 ATS(Application Transport Security)가 기본적으로 사용됩니다. 개발 중에 앱을 실행하려는 경우 ATS를 사용 안함으로 설정할 수 있습니다(자세히 보기).

1. Xcode에서 [프로젝트]/info.plist 파일 → 다른 이름으로 열기 → 소스 코드를 마우스 오른쪽 단추로 클릭하십시오.
2. 다음을 붙여넣으십시오.

     <key>NSAppTransportSecurity</key>
     <dict>
           <key>NSAllowsArbitraryLoads</key>
           <true/>
     </dict>

Apple watchOS에 대한 지원 추가

Apple watchOS 2 이상에 대해 개발 중인 경우 Podfile에는 기본 앱 및 watchOS 확장에 해당하는 섹션이 포함되어 있어야 합니다. watchOS 2에 대한 아래 예제를 참조하십시오.

# Replace with the name of your watchOS application
xcodeproj 'MyWatchApp'

use_frameworks!

#use the name of the iOS target
target :MyWatchApp do
    platform :ios, 9.0
    pod 'IBMMobileFirstPlatformFoundation'
    end

#use the name of the watch extension target
target :MyWatchApp WatchKit Extension do
    platform :watchos, 2.0
    pod 'IBMMobileFirstPlatformFoundation'
end

Xcode 프로젝트가 처리완료되었는지 확인하고 pod install 명령을 실행하십시오.

MobileFirst 네이티브 SDK 업데이트

최신 릴리스로 Mobile Foundation 네이티브 SDK를 업데이트하려면 명령행 창의 Xcode 프로젝트 루트 폴더에서 다음 명령을 실행하십시오.

pod update

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

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

mfpclient.plist

이 파일은 프로젝트의 루트에 있으며 MobileFirst Server에서 iOS 앱을 등록하는 데 사용되는 클라이언트 측 특성을 정의합니다.

비트 코드 및 TLS 1.2

비트 코드 및 TLS 1.2의 지원에 대한 정보는 추가 정보 페이지를 참조하십시오.

다음 학습서

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

• Mobile Foundation SDK 사용 학습서 검토
• 어댑터 개발 학습서 검토
• 인증 및 보안 학습서 검토
• 알림 학습서 검토
• 모든 학습서 검토