Bắt đầu

Tài liệu này giải thích cách bắt đầu phát triển bằng Nearby Messages API trên iOS.

Bước 1: Tải phiên bản Xcode mới nhất

Để tạo một dự án bằng Google Nearby Messages API cho iOS, bạn cần Xcode phiên bản 6.3 trở lên.

Bước 2: Tải CocoaPods

Google Nearby Messages API cho iOS có sẵn dưới dạng một pod CocoaPods. CocoaPods là một trình quản lý phần phụ thuộc nguồn mở cho các dự án Cocoa Swift và Objective-C.

Nếu bạn chưa có công cụ CocoaPods, hãy cài đặt công cụ này trên OS X bằng cách chạy lệnh sau đây từ thiết bị đầu cuối. Để biết thông tin chi tiết, hãy xem Hướng dẫn Bắt đầu sử dụng CocoaPods.

$ sudo gem install cocoapods

Bước 3: Cài đặt API bằng CocoaPods

Tạo một Podfile cho API Nearby Messages của Google cho iOS và dùng nó để cài đặt API cũng như các phần phụ thuộc của API.

  • Nếu bạn chưa có dự án Xcode, hãy tạo một dự án ngay bây giờ và lưu vào máy cục bộ. (Nếu bạn mới bắt đầu phát triển cho iOS, hãy tạo một Ứng dụng có một khung hiển thị và đảm bảo rằng bạn đã bật chế độ Sử dụng tính năng tự động đếm số lượt tham chiếu.)
  • Tạo một tệp có tên là Podfile trong thư mục dự án của bạn. Tệp này xác định các phần phụ thuộc của dự án.

  • Chỉnh sửa Podfile và thêm các phần phụ thuộc. Sau đây là một Podspec đơn giản, bao gồm tên của pod mà bạn cần cho Google Nearby Messages API cho iOS: 

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

  • Lưu Podfile.

  • Mở cửa sổ dòng lệnh rồi chuyển đến thư mục chứa Podfile:

    $ cd

  • Chạy lệnh pod install. Thao tác này sẽ cài đặt các API được chỉ định trong Podspec, cùng với mọi phần phụ thuộc mà các API đó có thể có.

    $ pod install

  • Đóng Xcode, rồi mở (nhấp đúp) tệp .xcworkspace của dự án để chạy Xcode. Từ thời điểm này trở đi, bạn phải sử dụng tệp .xcworkspace để mở dự án.

Bước 4: Tạo tiêu đề cầu nối (chỉ Swift)

Nếu đã tạo dự án bằng Swift, bạn phải thêm một tiêu đề cầu nối vào dự án để dự án có thể sử dụng các thư viện do tệp pod cài đặt. Hãy làm theo các bước sau để thêm một tiêu đề cầu nối:

  1. Trong cùng thư mục với tệp .xcworkspace của dự án, hãy thêm một tệp tiêu đề mới (đặt tên tuỳ ý và sử dụng đuôi tệp ".h").
  2. Dán mã sau vào tệp bạn đã tạo: #import <GNSMessages.h>.
  3. Lưu tệp.
  4. Trong ngăn bên trái của trình chỉnh sửa dự án, hãy chọn dự án chính.
  5. Nhấp vào Build Settings (Cài đặt bản dựng) ở đầu trình chỉnh sửa bản dựng.
  6. Trong phần Build Settings (Cài đặt bản dựng), hãy chuyển đến "Swift Compiler – Code Generation" (Trình biên dịch Swift – Tạo mã) (nhập "Swift Compiler" vào hộp tìm kiếm để nhanh chóng tìm thấy phần này).
  7. Nhấp vào mũi tên để mở rộng phần Objective-C Bridging Header (Tiêu đề cầu nối Objective-C).
  8. Trong mục Debug (Gỡ lỗi) và Release (Phát hành), hãy thêm đường dẫn đến tệp tiêu đề mà bạn đã tạo.
  9. Tạo dự án để các thay đổi có hiệu lực.

Bước 5: Lấy Tài khoản Google

Để sử dụng Nearby Messages API, bạn cần có Tài khoản Google. Nếu đã có tài khoản thì bạn có thể bỏ qua bước này. Bạn cũng nên có một Tài khoản Google riêng cho mục đích thử nghiệm.

Bước 6: Lấy khoá API

Hãy làm theo các bước sau để bật Google Nearby Messages API cho iOS và nhận khoá API:

  1. Chuyển đến Google Developers Console.
  2. Tạo hoặc chọn một dự án để đăng ký ứng dụng của bạn.
  3. Nhấp vào Tiếp tục để bật API.
  4. Trên trang Thông tin xác thực, hãy tạo một khoá iOS mới (và đặt Thông tin xác thực API).
    Lưu ý: Nếu đã có khoá iOS, bạn có thể sử dụng khoá đó.
  5. Trong hộp thoại xuất hiện, hãy nhập giá trị nhận dạng gói của ứng dụng. Ví dụ: 
    com.example.nearbyexample
  6. Khoá API iOS mới của bạn sẽ xuất hiện trong danh sách khoá API của dự án. Khoá API là một chuỗi ký tự, chẳng hạn như: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Để tránh bị đánh cắp hạn mức, hãy bảo mật khoá API theo các phương pháp hay nhất sau đây.

Bước 7: Tạo một đối tượng trình quản lý thông báo

Đối tượng trình quản lý thông báo cho phép bạn xuất bản và đăng ký. Trao đổi thông báo không được xác thực, vì vậy, bạn phải cung cấp khoá API mà bạn đã tạo ở bước trước.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")