Zacznij

Ostrzeżenie: funkcja wiadomości w pobliżu została wycofana i przestanie działać w grudniu 2023 r. Aby uzyskać dodatkową pomoc, przejdź do sekcji Połączenia z urządzeniami w pobliżu lub zapoznaj się z wytycznymi dotyczącymi migracji, które pomogą Ci przenieść korzystanie z dotychczasowych wiadomości z urządzeń w pobliżu do Połączeń z urządzeniami w pobliżu.

Z tego dokumentu dowiesz się, jak zacząć tworzyć aplikacje korzystające z interfejsu Nearby Messages API na iOS.

Krok 1. Pobierz najnowszą wersję Xcode

Aby utworzyć projekt za pomocą interfejsu Google Nearby Messages API na iOS, musisz mieć Xcode w wersji 6.3 lub nowszej.

Krok 2. Pobierz CocoaPods

Interfejs Google Nearby Messages API na iOS jest dostępny jako pakiet CocoaPods. CocoaPods to menedżer zależności typu open source dla projektów Cocoa w Swift i Objective-C.

Jeśli nie masz jeszcze zainstalowanego narzędzia CocoaPods, zainstaluj je w systemie OS X, wykonując w terminalu podane niżej polecenie. Więcej informacji znajdziesz w przewodniku wdrożeniowym CocoaPods.

$ sudo gem install cocoapods

Krok 3. Zainstaluj interfejs API za pomocą CocoaPods

Utwórz Podfile dla interfejsu Google Nearby Messages API na iOS i użyj go do zainstalowania interfejsu API i jego zależności.

• Jeśli nie masz jeszcze projektu Xcode, utwórz go i zapisz na komputerze lokalnym. Jeśli dopiero zaczynasz tworzyć aplikacje na iOS, utwórz aplikację z jednym widokiem i upewnij się, że opcja Użyj automatycznego zliczania odwołań jest włączona.
• W katalogu projektu utwórz plik o nazwie Podfile. Ten plik definiuje zależności projektu.

• Zmień plik Podfile i dodaj zależności. Oto prosty Podspec, w tym nazwa pod, której potrzebujesz do interfejsu Google Nearby Messages API na iOS:

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

• Zapisz Podfile.

• Otwórz terminal i przejdź do katalogu zawierającego plik Podfile:

  $ cd

• Uruchom polecenie pod install. Spowoduje to zainstalowanie interfejsów API określonych w pliku Podspec wraz z ich zależnościami.

  $ pod install

• Zamknij Xcode, a następnie otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Od tego momentu do otwierania projektu musisz używać pliku .xcworkspace.

Krok 4. Utwórz nagłówek pośredniczący (tylko w Swift)

Jeśli projekt został utworzony za pomocą Swift, musisz dodać do niego nagłówek pośredniczący, aby mógł korzystać z bibliotek zainstalowanych przez plik pod. Aby dodać nagłówek pośredni:

1. W tym samym katalogu, co plik .xcworkspace projektu, dodaj nowy plik nagłówka (nazwij go dowolnie i użyj rozszerzenia „.h”).
2. Wklej do utworzonego pliku ten kod: #import <GNSMessages.h>.
3. Zapisz plik.
4. W panelu po lewej stronie edytora projektu wybierz projekt główny.
5. U góry edytora wersji kliknij Ustawienia wersji.
6. W Ustawieniach kompilacji przejdź do „Kompilator Swift – generowanie kodu” (aby szybko ją znaleźć, wpisz w polu wyszukiwania „Kompilator Swift”).
7. Kliknij strzałkę, aby rozwinąć sekcję Nagłówek pośredniczący Objective-C.
8. W sekcji Debugowanie i Wersja na potrzeby publikowania dodaj ścieżkę do utworzonego pliku nagłówka.
9. Aby zmiany zaczęły obowiązywać, skompiluj projekt.

Krok 5. Utwórz konto Google

Aby używać interfejsów API Wiadomości w pobliżu, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić. Możesz też utworzyć osobne konto Google na potrzeby testów.

Krok 6. Pobierz klucz interfejsu API

Aby włączyć interfejs Google Nearby Messages API na iOS i uzyskać klucz API:

1. Otwórz Google Developers Console.
2. Utwórz lub wybierz projekt, w którym chcesz zarejestrować aplikację.
3. Aby włączyć interfejs API, kliknij Dalej.
4. Na stronie Dane logowania utwórz nowy klucz iOS (i ustaw dane logowania interfejsu API).
   Uwaga: jeśli masz już klucz iOS, możesz go użyć.
5. W oknie, które się wyświetli, wpisz identyfikator pakietu aplikacji. Na przykład:

   com.example.nearbyexample

6. Nowy klucz interfejsu API na iOS pojawi się na liście kluczy interfejsu API projektu. Klucz API to ciąg znaków, np.

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. Aby zapobiec kradzieży limitu, zabezpiecz klucz interfejsu API, postępując zgodnie z tymi sprawdzonymi metodami.

Uwaga: jeśli opracowujesz też aplikację na Androida lub używasz interfejsu Proximity Beacon REST API, wygeneruj wszystkie odpowiednie klucze API w tym samym projekcie w Konsoli programistów Google. Więcej informacji znajdziesz w przewodniku Pierwsze kroki na Androidzie oraz w Przewodniku Pierwsze kroki z interfejsem API REST

.

Krok 7. Utwórz obiekt MessageManager

Obiekt menedżera wiadomości umożliwia publikowanie i subskrybowanie. Wymiana wiadomości nie jest uwierzytelniana, dlatego musisz podać klucz interfejsu API utworzony w poprzednim kroku.

Objective-CSwift

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")