Rozpocznij

Z tego dokumentu dowiesz się, jak zacząć tworzyć aplikacje na iOS przy użyciu interfejsu Nearby Messages API.

Krok 1. Pobierz najnowszą wersję Xcode

Aby utworzyć projekt za pomocą interfejsu Google Nearby Messages API na iOS, musisz mieć wersję 6.3 lub nowszą Xcode.

Krok 2. Pobierz CocoaPods

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

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w systemie OS X, uruchamiając w terminalu to polecenie: Szczegółowe informacje znajdziesz w przewodniku CocoaPods Getting Started.

$ 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ę Single View i upewnij się, że opcja Use Automatic Reference Counting jest włączona).
  • Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik określa zależności projektu.

  • Edytuj plik Podfile i dodaj zależności. Oto prosty plik Podspec, który zawiera nazwę komponentu potrzebnego do korzystania z 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 wszelkimi zależnościami.

    $ pod install

  • Zamknij Xcode, a potem otwórz (kliknij dwukrotnie) plik .xcworkspace projektu, aby uruchomić Xcode. Od tego momentu musisz używać pliku .xcworkspace, aby otworzyć projekt.

Krok 4. Utwórz nagłówek pomostowy (tylko w przypadku Swift)

Jeśli projekt został utworzony w języku Swift, musisz dodać do niego plik nagłówkowy, aby mógł korzystać z bibliotek zainstalowanych przez plik pod. Aby dodać nagłówek pomostowy:

  1. W tym samym katalogu co plik .xcworkspace projektu dodaj nowy plik nagłówkowy (nadaj mu dowolną nazwę 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 kompilacji kliknij Ustawienia kompilacji.
  6. W ustawieniach kompilacji przejdź do sekcji „Swift Compiler – Code Generation” (aby ją szybko znaleźć, wpisz „Swift Compiler” w polu wyszukiwania).
  7. Kliknij strzałkę, aby rozwinąć sekcję Objective-C Bridging Header (Plik nagłówkowy pomostowy Objective-C).
  8. W sekcjach Debug i Release dodaj ścieżkę do utworzonego pliku nagłówkowego.
  9. Zbuduj projekt, aby zmiany zostały wprowadzone.

Krok 5. Utwórz konto Google

Aby korzystać z interfejsów Nearby Messages API, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić. Możesz też potrzebować osobnego konta Google do celów testowych.

Krok 6. Uzyskiwanie klucza 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. Kliknij Dalej, aby włączyć interfejs API.
  4. Na stronie Dane logowania utwórz nowy klucz iOS (i skonfiguruj dane logowania interfejsu API).
    Uwaga: jeśli masz już klucz iOS, możesz go użyć.
  5. W wyświetlonym oknie 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 interfejsu 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.

Krok 7. Utwórz obiekt menedżera wiadomości

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")