Rozpocznij

Z tego dokumentu dowiesz się, jak rozpocząć tworzenie aplikacji na iOS za pomocą interfejsu Nearby Messages API.

Krok 1. Pobierz najnowszą wersję Xcode

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

Krok 2. Pobierz CocoaPods

Interfejs Google Nearby Messages API na iOS jest dostępny jako 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 narzędzia CocoaPods, zainstaluj je w OS X, uruchamiając w terminalu to polecenie. Więcej informacji znajdziesz w przewodniku dla początkujących CocoaPods Getting Started.

$ sudo gem install cocoapods

Krok 3. Zainstaluj interfejs API za pomocą CocoaPods

Utwórz plik Podfile dla interfejsu Google Nearby Messages API na iOS i użyj go do zainstalowania interfejsu API oraz 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 jest włączona opcja Use Automatic Reference Counting).
  • W katalogu projektu utwórz 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ę poda 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 plik 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 tej pory do otwierania projektu musisz używać pliku .xcworkspace.

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

Jeśli projekt został utworzony w Swift, musisz dodać do niego nagłówek pomostowy, aby mógł korzystać z bibliotek zainstalowanych przez plik poda. 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 w polu wyszukiwania „Swift Compiler”).
  7. Kliknij strzałkę, aby rozwinąć sekcję Objective-C Bridging Header.
  8. W sekcjach Debug i Release dodaj ścieżkę do utworzonego pliku nagłówkowego.
  9. Aby zmiany zostały wprowadzone, skompiluj projekt.

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. Uzyskaj klucz interfejsu API

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

  1. Otwórz Google Developers Console.
  2. Utwórz projekt 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 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 w Twoim projekcie. 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, dlatego 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")