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:
- W tym samym katalogu co plik
.xcworkspace
projektu dodaj nowy plik pliku nagłówka (nadaj mu dowolną nazwę i użyj rozszerzenia „.h”). - Wklej ten kod do utworzonego pliku:
#import <GNSMessages.h>
- Zapisz plik.
- W panelu po lewej stronie edytora projektów wybierz projekt główny.
- U góry edytora kompilacji kliknij Ustawienia kompilacji.
- W ustawieniach kompilacji przejdź do „Swift Compiler – Code Generation” (typ „Swift Compiler” w polu wyszukiwania, aby je szybko znaleźć).
- Kliknij strzałkę, aby rozwinąć sekcję Objective-C Bridging Header (Nagłówek mostu Objective-C).
- W sekcjach Debugowanie i Wersja dodaj ścieżkę do pliku nagłówka, Utworzono.
- 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:
- Przejdź do Google Developers Console.
- Utwórz lub wybierz projekt, w którym chcesz zarejestrować aplikację.
- Kliknij Dalej, aby włączyć interfejs API.
- 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ć. - W wyświetlonym oknie wpisz identyfikator pakietu aplikacji. Na przykład:
com.example.nearbyexample
- 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
- 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")