시작하기

이 문서에서는 iOS에서 Nearby Messages API를 사용하여 개발을 시작하는 방법을 설명합니다.

1단계: Xcode 최신 버전 가져오기

iOS용 Google Nearby Messages API를 사용하여 프로젝트를 빌드하려면 Xcode 버전 6.3 이상이 필요합니다.Xcode

2단계: CocoaPods 가져오기

iOS용 Google Nearby Messages API는 CocoaPods 포드로 제공됩니다. CocoaPods는 Swift 및 Objective-C Cocoa 프로젝트용 오픈소스 종속 항목 관리자입니다.

CocoaPods 도구가 아직 없다면 터미널에서 다음 명령어를 실행하여 OS X에 설치합니다. 자세한 내용은 CocoaPods 시작 가이드를 참고하세요.

$ sudo gem install cocoapods

3단계: CocoaPods를 사용하여 API 설치

iOS용 Google Nearby Messages API의 Podfile를 만들고 이를 사용하여 API와 종속 항목을 설치합니다.

  • 아직 Xcode 프로젝트가 없으면 지금 만들어 로컬 머신에 저장합니다. iOS 개발을 처음 사용하는 경우에는 단일 뷰 애플리케이션을 만들고 자동 참조 계산 사용이 사용 설정되어 있는지 확인하세요.
  • 프로젝트 디렉터리에 Podfile 파일을 만듭니다. 이 파일은 프로젝트의 종속 항목을 정의합니다.
  • Podfile을 수정하고 종속 항목을 추가합니다. 다음은 iOS용 Google Nearby Messages API에 필요한 포드 이름이 포함된 간단한 Podspec입니다.

    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '7.0'
    pod 'NearbyMessages'

  • Podfile을 저장합니다.

  • 터미널을 열고 Podfile가 포함된 디렉터리로 이동합니다.

    $ cd

  • pod install 명령어를 실행합니다. 그러면 Podspec에 지정된 API가 설치되고 해당 종속 항목이 함께 설치됩니다.

    $ pod 설치

  • Xcode를 닫고 프로젝트의 .xcworkspace 파일을 (더블클릭하여) 열어 Xcode를 실행합니다. 지금부터는 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

4단계: 브리징 헤더 만들기 (Swift만 해당)

Swift를 사용하여 프로젝트를 만든 경우 포드 파일에서 설치한 라이브러리를 사용할 수 있도록 프로젝트에 브리징 헤더를 추가해야 합니다. 브리징 헤더를 추가하려면 다음 단계를 따르세요.

  1. 프로젝트의 .xcworkspace 파일과 동일한 디렉터리에 새 헤더 파일을 추가합니다. 원하는 이름을 지정하고 파일 이름 확장자 '.h'를 사용합니다.
  2. 생성된 파일에 #import <GNSMessages.h> 코드를 붙여넣습니다.
  3. 파일을 저장합니다.
  4. 프로젝트 편집기 왼쪽 창에서 기본 프로젝트를 선택합니다.
  5. 빌드 편집기 상단의 Build Settings(빌드 설정)를 클릭합니다.
  6. Build Settings에서 'Swift Compiler - Code Generation'(Swift 컴파일러 - 코드 생성)로 이동합니다(검색창에 'Swift Compiler'를 입력하여 빠르게 찾을 수 있음).
  7. 화살표를 클릭하여 Objective-C 브리징 헤더 섹션을 펼칩니다.
  8. 디버그출시에서 생성한 헤더 파일의 경로를 추가합니다.
  9. 프로젝트를 빌드하여 변경사항을 적용합니다.

5단계: Google 계정 만들기

Nearby Messages API를 사용하려면 Google 계정이 필요합니다. 계정이 있는 경우 별도의 조치를 취할 필요가 없습니다. 테스트용으로 별도의 Google 계정이 필요할 수도 있습니다.

6단계: API 키 가져오기

다음 단계에 따라 iOS용 Google Nearby Messages API를 사용 설정하고 API 키를 가져오세요.

  1. Google Developers Console로 이동합니다.
  2. 애플리케이션을 등록할 프로젝트를 만들거나 선택합니다.
  3. 계속을 클릭하여 API를 사용 설정합니다.
  4. 사용자 인증 정보 페이지에서 새 iOS 키를 만들고 API 사용자 인증 정보를 설정합니다.
    참고: 기존 iOS 키가 있으면 해당 키를 사용할 수 있습니다.
  5. 표시되는 대화상자에서 앱의 번들 식별자를 입력합니다. 예:
    com.example.nearbyexample
  6. 프로젝트의 API 키 목록에 새 iOS API 키가 나타납니다. API 키는 다음과 같은 문자열입니다.
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. 할당량 도난을 방지하려면 다음 권장사항에 따라 API 키를 보호하세요.

7단계: 메시지 관리자 객체 만들기

메시지 관리자 객체를 사용하면 게시하고 구독할 수 있습니다. 메시지 교환은 인증되지 않으므로 이전 단계에서 만든 API 키를 제공해야 합니다.

Objective-C

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")