Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 API Google Nearby Messages cho iOS, bạn cần có Xcode phiên bản 6.3 trở lên.
Bước 2: Tải CocoaPods
API Google Nearby Messages cho iOS có sẵn dưới dạng 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ừ dòng lệnh. Để biết thông tin chi tiết, hãy xem Hướng dẫn bắt đầu sử dụng CocoaPods.
$sudogeminstallcocoapods
Bước 3: Cài đặt API bằng CocoaPods
Tạo Podfile cho API Google Nearby Messages 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 và lưu dự án đó vào máy cục bộ. (Nếu bạn mới làm quen với việc phát triển iOS, hãy tạo một Ứng dụng thành phần hiển thị đơn và đảm bảo rằng bạn đã bật tính năng Sử dụng tính năng đếm tham chiếu tự động.)
Tạo một tệp có tên là 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 tên của pod mà bạn cần cho API Google Nearby Messages dành 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, 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ỉ 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 do tệp pod cài đặt.
Hãy làm theo các bước sau để thêm tiêu đề cầu nối:
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 bất kỳ và sử dụng đuôi tệp ".h").
Dán mã sau vào tệp bạn đã tạo: #import <GNSMessages.h>.
Lưu tệp.
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.
Nhấp vào Build Settings (Cài đặt bản dựng) ở đầu trình chỉnh sửa bản dựng.
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).
Nhấp vào mũi tên để mở rộng phần Tiêu đề cầu nối Objective-C.
Trong mục Gỡ lỗi và Phát hành, hãy thêm đường dẫn đến tệp tiêu đề bạn đã tạo.
Tạo bản 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 API Nearby Messages, 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:
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 hiện có, bạn có thể sử dụng khoá đó.
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
Khoá API iOS mới 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ự, chẳng hạn như:
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
Để ngăn chặn hành vi đá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.
Bước 7: Tạo đố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ý. Việc 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.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThe Nearby Messages API is deprecated and will stop working in December 2023, with users encouraged to migrate to Nearby Connections.\u003c/p\u003e\n"],["\u003cp\u003eDeveloping with the Nearby Messages API on iOS requires Xcode version 6.3 or later and the use of CocoaPods for dependency management.\u003c/p\u003e\n"],["\u003cp\u003eInstallation of the API is done via creating and editing a \u003ccode\u003ePodfile\u003c/code\u003e with a simple \u003ccode\u003epod install\u003c/code\u003e command in the terminal.\u003c/p\u003e\n"],["\u003cp\u003eSwift projects additionally require the creation of a bridging header file, referencing GNSMessages.h, and specifying the path to this in the project's build settings.\u003c/p\u003e\n"],["\u003cp\u003eUsing the API requires a Google account and an API key, which is generated in the Google Developers Console by enabling the Nearby Messages API.\u003c/p\u003e\n"]]],["The guide outlines the process for developing with the deprecated Nearby Messages API on iOS. Key actions include: installing Xcode (v6.3+), setting up CocoaPods for dependency management, creating a `Podfile` to install the 'NearbyMessages' pod, and adding a bridging header for Swift projects. A Google account and an iOS API key are needed, generated via the Google Developers Console using the app's bundle identifier. Finally, a message manager object is created using the API key to enable publishing and subscribing.\n"],null,["# Get Started\n\n| **Warning:** Nearby Messages is deprecated and will stop working as of December 2023. Please navigate to [Nearby Connections](//developers.google.com/nearby/connections/overview) for further support or [Migration Guideline](//developers.google.com/nearby/messages/ios/migrate-to-nc) on how to migrate existing Nearby Messages usage to Nearby Connections.\n\nThis document explains how to start developing with the Nearby Messages API on\niOS.\n\nStep 1: Get the latest version of Xcode\n---------------------------------------\n\nTo build a project using the Google Nearby Messages API for iOS, you need\n**version 6.3** or later of [Xcode](https://developer.apple.com/xcode/).\n\nStep 2: Get CocoaPods\n---------------------\n\nThe Google Nearby Messages API for iOS is available as a\n[CocoaPods](https://cocoapods.org/) pod. CocoaPods is an open source dependency\nmanager for Swift and Objective-C Cocoa projects.\n\nIf you don't already have the CocoaPods tool, install it on OS X by running the\nfollowing command from the terminal. For details, see the [CocoaPods Getting\nStarted guide](https://guides.cocoapods.org/using/getting-started.html). \n\n $ sudo gem install cocoapods\n\nStep 3: Install the API using CocoaPods\n---------------------------------------\n\nCreate a `Podfile` for the Google Nearby Messages API for iOS and use it to\ninstall the API and its dependencies.\n\n- If you don't have an Xcode project yet, create one now and save it to your local machine. (If you're new to iOS development, create a Single View Application, and ensure that Use Automatic Reference Counting is turned on.)\n- Create a file named `Podfile` in your project directory. This file defines your project's dependencies.\n- Edit the `Podfile` and add your dependencies. Here is a simple Podspec,\n including the name of the pod you need for the Google Nearby Messages API for\n iOS:\n\n ```text\n source 'https://github.com/CocoaPods/Specs.git'\n platform :ios, '7.0'\n pod 'NearbyMessages'\n ```\n\n \u003cbr /\u003e\n\n- Save the `Podfile`.\n\n- Open a terminal and go to the directory containing the `Podfile`:\n\n $ cd\n- Run the `pod install` command. This will install the APIs specified in the\n Podspec, along with any dependencies they may have.\n\n $ pod install\n- Close Xcode, and then open (double-click) your project's `.xcworkspace` file\n to launch Xcode. From this time onwards, you must use the `.xcworkspace` file to\n open the project.\n\nStep 4: Create a bridging header (Swift only)\n---------------------------------------------\n\nIf you created your project using Swift, you must add a bridging header to your\nproject so that it can use the libraries that were installed by the pod file.\nTake these steps to add a bridging header:\n\n1. In the same directory as your project's `.xcworkspace` file, add a new header file (name it whatever you like and use a filename extension of \".h\").\n2. Paste the following code into the file you created: `#import \u003cGNSMessages.h\u003e`.\n3. Save the file.\n4. In the project editor left pane, select the main project.\n5. Click **Build Settings** at the top of the build editor.\n6. In Build Settings, navigate to \"Swift Compiler - Code Generation\" (type \"Swift Compiler\" into the search box to locate it quickly).\n7. Click the arrow to expand the **Objective-C Bridging Header** section.\n8. Under **Debug** and **Release**, add the path to the header file you created.\n9. Build the project to make the changes take effect.\n\nStep 5: Get a Google account\n----------------------------\n\nTo use the Nearby Messages APIs, you need a [Google Account](//www.google.com/accounts/NewAccount).\nIf you already have an account, then you're all set. You may also want a\nseparate Google Account for testing purposes.\n\nStep 6: Get an API key\n----------------------\n\nTake these steps to enable the Google Nearby Messages API for iOS and get an\nAPI key:\n\n1. Go to the [Google Developers Console](https://console.developers.google.com/flows/enableapi?apiid=copresence&keyType=CLIENT_SIDE_IOS&reusekey=true).\n2. Create or select a project to register your application with.\n3. Click **Continue** to Enable the API.\n4. On the **Credentials** page, create a new **iOS key** (and set the API Credentials). \n Note: If you have an existing **iOS key**, you may use that key.\n5. In the resulting dialog, enter your app's bundle identifier. For example: \n\n ```\n com.example.nearbyexample\n ```\n6. Your new iOS API key appears in the list of API keys for your project. An API key is a string of characters, something like this: \n\n ```\n AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0\n ```\n7. To prevent quota theft, secure your API key following these [best practices](/console/help/console#apikeybestpractices).\n\n| **Note:** If you are also developing an Android app, or using the Proximity Beacon REST API, make sure you generate all respective API keys within the same Google Developers Console project. For more information, see the [Getting Started guide for Android](/nearby/messages/android/get-started), and [Get Started with the REST API](/beacons/proximity/get-started).\n\nStep 7: Create a message manager object\n---------------------------------------\n\nThe message manager object lets you publish and subscribe. Message exchange is\nunauthenticated, so you must supply the API key you created in the previous\nstep.\n\n\u003cbr /\u003e\n\n### Objective-C\n\n\u003cbr /\u003e\n\n #import \u003cGNSMessages.h\u003e\n\n GNSMessageManager *messageManager =\n [[GNSMessageManager alloc] initWithAPIKey:@\"API_KEY\"];\n\n\u003cbr /\u003e\n\n### Swift\n\n\u003cbr /\u003e\n\n let messageManager = GNSMessageManager(APIKey: \"API_KEY\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e"]]
