Bắt đầu

Cảnh báo: Ứng dụng Tin nhắn lân cận không còn được dùng nữa và sẽ ngừng hoạt động kể từ tháng 12 năm 2023. Vui lòng chuyển đến phần Kết nối lân cận để được hỗ trợ thêm hoặc chuyển đến Nguyên tắc di chuyển về cách di chuyển hoạt động sử dụng ứng dụng Tin nhắn lân cận sang tính năng Kết nối lân cận.

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

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

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

Bước 2: Tải CocoaPods

API Thông báo lân cận của Google dành cho iOS được cung cấp dưới dạng nhóm CocoaPods. CocoaPods là trình quản lý phần phụ thuộc nguồn mở cho các dự án Swift và Objective-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 lệnh sau 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 Google Nearby Message API dành cho iOS và sử dụng API này để 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 dự án đó vào máy cục bộ. (Nếu bạn mới sử dụng tính năng phát triển iOS, hãy tạo một Ứng dụng Khung hiển thị đơn và đảm bảo rằng bạn đã bật tuỳ chọn 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. Dưới đây là một Podspec đơn giản, bao gồm cả tên của nhóm bạn cần cho Google Nearby Message 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 có thể có.

  cài đặt $ Pod

• Đóng Xcode, sau đó 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ỉ 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 để dự án có thể sử dụng các thư viện đã được cài đặt bằng tệp nhóm. 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 tiêu đề mới (đặt tên theo ý bạn 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 mục "Swift Compiler - Code Creation" (Trình biên dịch Swift – Tạo mã) (nhập "Swift Compiler" vào hộp tìm kiếm để tìm nhanh trình biên dịch).
7. Nhấp vào mũi tên để mở rộng mục Tiêu đề cầu nối Objective-C.
8. Trong phần Debug (Gỡ lỗi) và Release (Phát hành), hãy thêm đường dẫn vào tệp tiêu đề mà bạn đã tạo.
9. Tạo dự án để thực hiện các thay đổi có hiệu lực.

Bước 5: Đăng ký 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 đã hoàn tất. 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

Làm theo các bước sau để bật Google Nearby Message 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.
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 hiện ra, hãy nhập mã nhận dạng gói của ứng dụng. Ví dụ:

   com.example.nearbyexample

6. Khoá API mới dành cho iOS 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. Để ngăn chặn hành vi đánh cắp hạn mức, hãy bảo mật khoá API của bạn theo các phương pháp hay nhất sau.

Lưu ý: Nếu bạn cũng đang phát triển một ứng dụng Android hoặc đang sử dụng API REST báo hiệu khoảng gần, hãy nhớ tạo tất cả các khoá API tương ứng trong cùng một dự án Google Developers Console. Để biết thêm thông tin, hãy xem Hướng dẫn bắt đầu sử dụng Android và Bắt đầu sử dụng API REST.

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ý. Hoạt động trao đổi thông báo chưa đượ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")