Rozpocznij

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

Krok 1. Pobierz najnowszą wersję Xcode

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

Krok 2. Kup CocoaPods

Interfejs Google w pobliżu do aplikacji Wiadomości na iOS jest dostępny w postaci poda CocoaPods. CocoaPods to menedżer zależności typu open source dla projektów Swift i Objective-C Cocoa.

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w OS X, uruchamiając to polecenie z terminala. Szczegółowe informacje znajdziesz w przewodniku CocoaPods dla początkujących.

$ sudo gem install cocoapods

Krok 3. Zainstaluj interfejs API za pomocą CocoaPods

Utwórz obiekt Podfile dla interfejsu Google w pobliżu do interfejsu API Wiadomości w pobliżu na iOS i użyj go do zainstalowania tego interfejsu API oraz jego zależności.

  • Jeśli nie masz jeszcze projektu Xcode, utwórz go teraz i zapisz na komputerze lokalnym. (Jeśli nie masz doświadczenia w programowaniu z iOS, utwórz aplikację z jednym widokiem i upewnij się, że opcja Używaj automatycznego liczenia plików referencyjnych 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 prosta podspecjalizacja, w tym nazwa poda potrzebnego do działania interfejsu Google Connected 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 Podfile:

    $ cd

  • Uruchom polecenie pod install. Spowoduje to zainstalowanie interfejsów API określonych w Podspecjce i wszystkich zależności, jakie mogą one mieć.

    $ instalacja podów

  • Zamknij Xcode, a następnie otwórz (dwukrotnie) plik .xcworkspace swojego projektu, aby uruchomić Xcode. Od tej pory projekt będzie można otwierać tylko za pomocą pliku .xcworkspace.

Krok 4. Utwórz nagłówek łączący (tylko Swift)

Jeśli projekt został utworzony za pomocą kodu Swift, musisz dodać do niego nagłówek łączący, aby mógł korzystać z bibliotek zainstalowanych przez plik poda. Aby dodać nagłówek łączący, wykonaj te czynności:

  1. W tym samym katalogu co plik .xcworkspace projektu dodaj nowy plik nagłówka (nadaj mu dowolną nazwę i nadaj mu rozszerzenie „.h”).
  2. Wklej ten kod do utworzonego pliku: #import <GNSMessages.h>.
  3. Zapisz plik.
  4. W panelu po lewej stronie edytora projektu wybierz główny projekt.
  5. U góry edytora kompilacji kliknij Ustawienia kompilacji.
  6. W ustawieniach kompilacji otwórz „Swift Compiler – generowanie kodu” (wpisz „Swift Compiler” w polu wyszukiwania, by szybko go znaleźć).
  7. Kliknij strzałkę, aby rozwinąć sekcję Objective-C Bridging Header.
  8. W sekcjach Debugowanie i Wersja dodaj ścieżkę do utworzonego pliku nagłówka.
  9. Aby wprowadzić zmiany, utwórz projekt.

Krok 5. Załóż konto Google

Aby korzystać z interfejsów API Wiadomości w pobliżu, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic robić. Do testowania możesz też utworzyć osobne konto Google.

Krok 6. Uzyskaj klucz interfejsu API

Aby włączyć interfejs Google w pobliżu do interfejsu API Wiadomości w pobliżu 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 ustaw dane logowania interfejsu API.
    Uwaga: jeśli masz klucz iOS, możesz go użyć.
  5. W wyświetlonym oknie wpisz identyfikator pakietu aplikacji. Na przykład:
    com.example.nearbyexample
  6. Twój nowy klucz interfejsu API dla iOS pojawi się na liście kluczy interfejsu API w Twoim projekcie. Klucz interfejsu API to ciąg znaków podobny do tego:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Aby zapobiec kradzieży limitu, zabezpiecz klucz interfejsu API 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")