Rozpocznij

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

Krok 1. Pobierz najnowszą wersję Xcode

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

Krok 2. Pobierz CocoaPods

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

Jeśli nie masz jeszcze narzędzia CocoaPods, zainstaluj je w systemie OS X przy użyciu polecenia z terminala. Szczegółowe informacje znajdziesz w artykule CocoaPods odbiera Uruchomiony przewodnik

$ sudo gem install cocoapods

Krok 3. Zainstaluj interfejs API za pomocą CocoaPods

Utwórz Podfile dla interfejsu Google Near Messages API na iOS i użyj go do: zainstalować interfejs API i 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 aplikacji na iOS, utwórz widok pojedynczego aplikacji i upewnij się, że opcja Używaj automatycznego liczenia plików referencyjnych jest włączona).
  • Utwórz w katalogu projektu plik o nazwie Podfile. Ten plik określa w zależności od projektu.
  • Edytuj Podfile i dodaj zależności. Oto prosty specyfikacja poda, w tym nazwę poda potrzebnego do korzystania z interfejsu Google Near Messages API dla System 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 specyfikacja poda wraz z wszelkimi zależnościami.

    Liczba instalacji podów: $

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

Krok 4. Utwórz nagłówek połączenia (tylko Swift)

Jeśli Twój projekt został utworzony w języku Swift, do nagłówka połączenia musisz dodać nagłówek połączenia. projektu, dzięki czemu może używać bibliotek zainstalowanych przez plik poda. Aby dodać nagłówek połączenia, wykonaj te czynności:

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

Krok 5. Utwórz 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ć. Warto też oddzielne konto Google do celów testowych.

Krok 6. Uzyskaj klucz interfejsu API

Wykonaj te czynności, aby włączyć interfejs Google Broad Messages API na iOS i uzyskać Klucz interfejsu API:

  1. Przejdź do 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 interfejs API). Dane logowania).
    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. Nowy klucz interfejsu API iOS pojawi się na liście kluczy interfejsu API projektu. Klucz interfejsu API to ciąg znaków, na przykład:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. Aby zapobiec kradzieży limitu, zabezpiecz swój klucz interfejsu API zgodnie z tymi wytycznymi sprawdzonych metodach.
.

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

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")