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 dự án bằng API Google Nearby Messages dành cho iOS, bạn cần phiên bản 6.3 trở lên của Xcode.

Bước 2: Mua CocoaPods

Google Nearby Messages API dành cho iOS được cung cấp dưới dạng CocoaPods. CocoaPods là phần phụ thuộc nguồn mở quản lý cho các dự án Swift và GOAL-C Cacao.

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 sau đây từ thiết bị đầu cuối. Để biết chi tiết, hãy xem bài viết Hướng dẫn về CocoaPods Hướng dẫn bắt đầu sử dụng.

$ sudo gem install cocoapods

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

Tạo Podfile cho Google Nearby Messages API dành cho iOS và sử dụng API này để cài đặt API và 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 phát triển iOS, hãy tạo một Chế độ xem duy nhất Áp dụng và đảm bảo rằng bạn đã bật chế độ Sử dụng tính năng đếm tham chiếu tự động.)
  • Tạo một tệp có tên Podfile trong thư mục dự á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. Đây là một Podspec đơn giản, bao gồm cả tên của nhóm cần thiết cho Google Nearby Messages API 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 bất kỳ phần phụ thuộc nào mà chúng có thể có.

    lượt cài đặt nhóm $

  • Đóng Xcode rồi mở (nhấp đúp) tệp .xcworkspace của dự án để khởi 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ỉ dành cho Swift)

Nếu đã tạo dự án bằng Swift, bạn phải thêm tiêu đề cầu nối vào dự án để có thể sử dụng các thư viện mà tệp nhóm đã cài đặt. Hãy làm theo các bước sau để thêm 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 mới tệp tiêu đề (đặt tên tuỳ thích và sử dụng đuôi tệp là ".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ã) (loại "Trình biên dịch Swift" vào hộp tìm kiếm để nhanh chóng tìm thấy mã).
  7. Nhấp vào mũi tên để mở rộng phần Tiêu đề cầu nối Target-C.
  8. Trong phần Gỡ lỗi và Bản phát hành, hãy thêm đường dẫn đến tệp tiêu đề mà bạn đã tạo.
  9. Xây dựng dự án để các thay đổi có hiệu lực.

Bước 5: Tạo 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ắt đầu sử dụng. Có thể bạn cũng muốn riêng Tài khoản Google cho mục đích thử nghiệm.

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

Làm theo các bước sau để bật Google Nearby Messages API dành 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 đăng nhập, tạo một khoá iOS mới (và đặt API Thông tin xác thực).
    Lưu ý: Nếu đã có khoá iOS thì bạn có thể dùng khoá đó.
  5. Trong hộp thoại thu được, hãy nhập giá trị nhận dạng gói ứ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 cho dự án của bạn. Khoá API là một chuỗi ký tự, có dạng như sau: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Để tránh bị đánh cắp hạn mức, hãy bảo mật khoá API bằng những cách sau các phương pháp hay nhất.

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

Đối tượng trình quản lý thông báo cho phép bạn đăng và đăng ký. Trao đổi tin nhắn là chưa được xác thực, do đó bạn phải cung cấp khoá API mà bạn đã tạo ở trên .

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")