이 문서에서는 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를 사용하여 프로젝트를 만든 경우 포드 파일에서 설치한 라이브러리를 사용할 수 있도록 프로젝트에 브리징 헤더를 추가해야 합니다. 브리징 헤더를 추가하려면 다음 단계를 따르세요.
- 프로젝트의
.xcworkspace
파일과 동일한 디렉터리에 새 헤더 파일을 추가합니다. 원하는 이름을 지정하고 파일 이름 확장자 '.h'를 사용합니다. - 생성된 파일에
#import <GNSMessages.h>
코드를 붙여넣습니다. - 파일을 저장합니다.
- 프로젝트 편집기 왼쪽 창에서 기본 프로젝트를 선택합니다.
- 빌드 편집기 상단의 Build Settings(빌드 설정)를 클릭합니다.
- Build Settings에서 'Swift Compiler - Code Generation'(Swift 컴파일러 - 코드 생성)로 이동합니다(검색창에 'Swift Compiler'를 입력하여 빠르게 찾을 수 있음).
- 화살표를 클릭하여 Objective-C 브리징 헤더 섹션을 펼칩니다.
- 디버그 및 출시에서 생성한 헤더 파일의 경로를 추가합니다.
- 프로젝트를 빌드하여 변경사항을 적용합니다.
5단계: Google 계정 만들기
Nearby Messages API를 사용하려면 Google 계정이 필요합니다. 계정이 있는 경우 별도의 조치를 취할 필요가 없습니다. 테스트용으로 별도의 Google 계정이 필요할 수도 있습니다.
6단계: API 키 가져오기
다음 단계에 따라 iOS용 Google Nearby Messages API를 사용 설정하고 API 키를 가져오세요.
- Google Developers Console로 이동합니다.
- 애플리케이션을 등록할 프로젝트를 만들거나 선택합니다.
- 계속을 클릭하여 API를 사용 설정합니다.
- 사용자 인증 정보 페이지에서 새 iOS 키를 만들고 API 사용자 인증 정보를 설정합니다.
참고: 기존 iOS 키가 있으면 해당 키를 사용할 수 있습니다. - 표시되는 대화상자에서 앱의 번들 식별자를 입력합니다. 예:
com.example.nearbyexample
- 프로젝트의 API 키 목록에 새 iOS API 키가 나타납니다.
API 키는 다음과 같은 문자열입니다.
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
- 할당량 도난을 방지하려면 다음 권장사항에 따라 API 키를 보호하세요.
7단계: 메시지 관리자 객체 만들기
메시지 관리자 객체를 사용하면 게시하고 구독할 수 있습니다. 메시지 교환은 인증되지 않으므로 이전 단계에서 만든 API 키를 제공해야 합니다.
Objective-C
#import <GNSMessages.h>
GNSMessageManager *messageManager =
[[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];
Swift
let messageManager = GNSMessageManager(APIKey: "API_KEY")