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: Więcej informacji znajdziesz w przewodniku dla początkujących dotyczącym 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ę Single View i upewnij się, że opcja Use Automatic Reference Counting (Użyj automatycznego zliczania odwołań) jest włączona).
  • W katalogu projektu utwórz plik o nazwie Podfile. Ten plik określa zależności projektu.

  • Edytuj 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 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 musisz używać pliku .xcworkspace, aby otworzyć projekt.

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

Jeśli projekt został utworzony za pomocą języka Swift, musisz dodać do niego nagłówek pomostowy, 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 otwórz „Swift Compiler – Code Generation” (aby szybko znaleźć tę opcję, 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. Skompiluj projekt, aby wprowadzić zmiany.

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. Aby włączyć interfejs API, kliknij Dalej.
  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 limitów, 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")