이 페이지는 Cloud Translation API를 통해 번역되었습니다.

시작하기

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

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

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

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

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

$ sudo gem install cocoapods

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

아직 Xcode 프로젝트가 없으면 지금 만들어 로컬 시스템에 저장합니다. (iOS 개발을 처음 시작하는 경우 Single View Application을 만들고 Use Automatic Reference Counting이 켜져 있는지 확인합니다.)
프로젝트 디렉터리에 Podfile 파일을 만듭니다. 이 파일은 프로젝트의 종속 항목을 정의합니다.
Podfile을 수정하고 종속 항목을 추가합니다. 다음은 iOS용 Google Nearby Messages API에 필요한 pod의 이름이 포함된 간단한 Podspec입니다.
```
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'
```
Podfile을 저장합니다.
터미널을 열고 Podfile가 포함된 디렉터리로 이동합니다.

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

$ pod install
Xcode를 닫은 다음 프로젝트의 .xcworkspace 파일을 (더블클릭하여) 열어 Xcode를 실행합니다. 이 때부터는 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

Swift를 사용하여 프로젝트를 생성했다면 프로젝트에 브리징 헤더를 추가하여 프로젝트에서 pod 파일로 설치된 라이브러리를 사용할 수 있게 해야 합니다. 브리징 헤더를 추가하려면 다음 단계를 따르세요.

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

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

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

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

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

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")