license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations

under the License.

Przewodnik platformy Android

Ten poradnik pokazuje jak skonfigurować SDK środowiska wdrażania Cordova aplikacje dla systemu Android urządzeń i jak ewentualnie użyć narzędzi wiersza polecenia skoncentrowanych na Android w pracy rozwoju. Musisz zainstalować Android SDK, bez względu na to, czy chcesz użyć tych skoncentrowanych na platformie powłoka narzędzia lub CLI Cordova przekreślać platforma dla rozwoju. Dla porównania dwóch rozwoju ścieżki zobacz Omówienie. Szczegóły na CLI Zobacz interfejs wiersza poleceń.

Wymagania i wsparcie

Cordova, Android wymaga Android SDK. Zobacz Android SDK wymagania systemowe.

Cordova obsługuje Android 2.3.x (Piernik, począwszy od 10 poziomu gry Android API) i 4.x. Jako zasadę ogólną Androida w wersji stają się obsługiwane przez Cordova, jak one spadną poniżej 5% na Google panel dystrybucji. Androida w wersji starszej niż API poziom 10, oraz wersje 3.x (Honeycomb, API, poziom 11-13) spadnie znacznie poniżej tego progu 5%.

Zainstaluj narzędzia powłoki Cordova

Jeśli chcesz użyć Cordova w środku Android powłoka narzędzia w połączeniu z zestawu SDK, należy pobrania Cordova, z cordova.apache.org. Inaczej ignorować tej sekcji, jeśli masz zamiar używać narzędzia CLI przekreślać platforma opisanego w interfejs wiersza poleceń.

Pobierz Cordova zawiera osobne Archiwum dla każdej platformy. Pamiętaj rozwinąć odpowiednie archiwum, android w tym przypadku w pusty katalog. Odpowiednie narzędzia executible są dostępne w katalogu głównym bin katalogu. (Konsultacje w pliku README , jeśli jest to konieczne dla bardziej szczegółowe wskazówki).

Te powłoka narzędzia pozwalają na tworzenie, budować i uruchamiać aplikacje. O dodatkowy interfejs wiersza poleceń, który umożliwia funkcji plugin na wszystkich platformach Zobacz za pomocą Plugman do zarządzania wtyczki. Zobacz szczegóły jak rozwijać wtyczki wtyczki aplikacji.

Zainstalować Android SDK z developer.android.com/sdk. Android sdk jest dystrybuowany w postaci pliku ‘adt - pakiet - < os > - < arch > - < ver >’. W systemie windows pakietu adt jest pakowane z Instalatora. Na OSX i Linux, zwykłe rozpakować “adt pakiet” w miejscu przechowywania narzędzi programistycznych. Bardziej szczegółowe informacje na temat instalacji Android SDK można znaleźć tutaj

Cordova wiersza polecenia narzędzia do pracy, lub CLI, który opiera się na nich, ty potrzebować wobec zawierać SDK tools i platform-tools katalogi w swojej PATH . Na komputerze Mac, można użyć edytora tekstu do tworzenia lub modyfikowania ~/.bash_profile pliku, dodanie linii następujących, w zależności od tego, gdzie instaluje zestawu SDK:

    export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools

Dodać ścieżki dla java i ant w razie potrzeby. Tej linii w ~/.bash_profile udostępnia te narzędzia w nowo otwartego okna terminala. Jeśli twój koñcowy okno jest już otwarta w OSX, lub w celu uniknięcia Logowanie/Wylogowanie na Linux, uruchom je udostępnić w bieżącym oknie terminala:

    $ source ~/.bash_profile

Aby zmodyfikować PATH środowiska na Windows 7:

Trzaskać u wzdrygnąć się menu w lewym dolnym rogu pulpitu, kliknij prawym przyciskiem myszy na komputerze, a następnie wybierz Właściwości.
Wybierz opcję Zaawansowane ustawienia systemu w kolumnie po lewej stronie.
W oknie dialogowym wynikowe naciśnij przycisk Zmienne środowiskowe.
Wybierz zmienną PATH i naciśnij klawisz Edytuj.
Dopisz następujące czynności, aby PATH w oparciu o gdzie zainstalowałeś SDK, na przykład:
```
;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
```
Zapisz wartość i zamknij obu oknach dialogowych.

Należy również włączyć Java i holenderskie otworzyć pewien rozkazywać wierzyciel i typ java , a także typu ant . Dołącz do PATH którykolwiek z tych nie można uruchomić:

    ;%JAVA_HOME%\bin;%ANT_HOME%\bin

Otworzyć nowy projekt w SDK

W tym momencie aby utworzyć nowy projekt można wybrać narzędzia CLI przekreślać platforma opisanego w interfejs wiersza poleceń, lub zbiór specyficznych dla systemu Android powłoka narzędzia. Z katalogu kodu źródłowego, tutaj jest podejście CLI:

    $ cordova create hello com.example.hello HelloWorld
    $ cd hello
    $ cordova platform add android
    $ cordova build

Tutaj jest odpowiednie podejście shell narzędzie niższego poziomu dla systemu Unix i Windows:

    $ /path/to/cordova-android/bin/create /path/to/new/hello com.example.hello HelloWorld
    C:\path\to\cordova-android\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

Oto jak zmodyfikować go za pomocą zestawu SDK:

Uruchamianie aplikacji Eclipse .
Wybierz element menu Nowy projekt .
Wybrać Projekt Android z istniejącego kodu wynikowego-okno dialogowe i naciśnij przycisk następny:
Jeśli używasz CLI, przejdź do hello tworzenia projektu, a następnie do katalogu platforms/android podkatalogu. Alternatywnie Jeśli używasz create powłoka narzędzia, po prostu przejdź do hello katalogu.
Naciśnij przycisk Zakończ.

Gdy otworzy się okno Eclipse, czerwony X mogą pojawiać się problemy nierozwiązane. Jeśli tak, wykonaj następujące kroki dodatkowe:

Kliknij prawym przyciskiem myszy na katalogu projektu.
W wyniku Właściwości okno dialogowe Wybierz Android z okienka nawigacji.
Dla projektu budowy docelowego, wybierz na najwyższym poziomie Android API, który został zainstalowany.
Kliknij przycisk OK.
Wybierz Clean z menu projekt . To powinno poprawić wszystkie błędy w projekcie.

Skompiluj projekt

Jeśli używasz CLI w rozwoju, katalogu projektu na najwyższym poziomie www katalog zawiera pliki źródłowe. Uruchomić wszelki od tych w katalogu projektu, aby odbudować aplikacji:

    $ cordova budować # budować wszystkich platform, które zostały dodane $ cordova budować android # budować debugowania dla tylko Android $ cordova budowy systemu android debug # budować debugowania Android tylko $ cordova budować Android--wydaniu # budować wydania tylko Android

Jeśli używasz Android specyficzne narzędzia powłoki w rozwoju, ma innego podejścia. Po wygenerowaniu projektu, domyślnie aplikacja źródła jest dostępnych w assets/www podkatalogu. Kolejne polecenia są dostępne w jego cordova podkatalogu.

buildPolecenie czyści pliki projektu i odbudowuje aplikacji. Oto składnia dla Mac i Windows. Pierwsze parę przykładów generowania informacji o debugowaniu, a drugi buduje aplikacje do wydania:

    $ /path/to/project/cordova/build --debug
    C:\path\to\project\cordova\build.bat --debug

    $ /path/to/project/cordova/build --release
    C:\path\to\project\cordova\build.bat --release

Podczas tworzenia wersji, jeśli można dodać następujące definicje do swojej local.properties pliku, a następnie twój APK otrzyma podpisane i dostosowane tak, że będzie gotowy do wysyłania do sklepu Google Play:

    Key.Store=/users/me/Developer/mykeystore.JKS key.alias=mykeyalias

Jeśli kluczy lub aliasu klucz hasła, skrypt wyświetli monit o hasło. Nie trzeba zdefiniować hasła w pliku właściwości. Jeśli chcesz uniknąć polecenia, można określić je w local.properties jako key.store.password i key.alias.password . Jeśli tak, należy pamiętać, dotyczy bezpieczeństwa z tych haseł.

Skonfigurować Emulator

Można użyć dowolnej cordova Narzędzia CLI lub Cordova w środku Android powłoki narzędzia do uruchamiania aplikacji w emulatorze. Tak czy inaczej, SDK musi być skonfigurowany do wyświetlania co najmniej jedno urządzenie. Aby to zrobić, należy użyć Menedżera SDK Android, aplikacji Java, który działa oddzielnie z Eclipse. Istnieją dwa sposoby, aby go otworzyć:

Uruchomić android w wierszu polecenia.
W Eclipse, naciśnij ten ikony paska narzędzi:

Po jej otwarciu, Android SDK Menedżer wyświetla różne biblioteki uruchomieniowe:

Wybierz Narzędzia → Zarządzaj AVDs (Android urządzenia wirtualnego), a następnie wybierz dowolny element z Definicji urządzenia w oknie dialogowym wynikowe:

Naciśnij przycisk Utwórz AVD, opcjonalnie Modyfikowanie nazwy, a następnie naciśnij OK , aby zaakceptować zmiany:

AVD następnie pojawia się na liście Urządzeń wirtualnych z systemem Android :

Aby otworzyć ten emulator jako oddzielną aplikację, wybierz AVD i naciśnij Start. Wprowadza to tyle jak na urządzenie, z dodatkowych formantów dostępnych przycisków sprzętowych:

Uruchamianie na emulatorze

W tym momencie można użyć cordova CLI narzędzia do wdrażania aplikacji do emulatora z linii poleceń:

    $ cordova naśladować Androida

W przeciwnym razie Użyj interfejs powłoki alternatywne:

    $ /path/to/project/cordova/run - emulator

Zamiast opierania się na cokolwiek emulatora jest obecnie włączona w zestawie SDK, można odwołać się do każdej nazwy, które należy dostarczyć:

    $ /path/to/project/cordova/run - cel = nazwa

To wyprowadziło aplikacji na ekranie i uruchamia to:

Kiedy ty run aplikacji, można również build to. Można dodać dodatkowe --debug , --release , i --nobuild flagi, aby kontrolować, jak jest zbudowany, lub nawet niezbędne jest czy przebudowy:

    $ /path/to/project/cordova/run - emulator--nobuild

Jeśli natomiast pracujesz w Eclipse, kliknij prawym przyciskiem myszy projekt i wybierz Uruchom jako → Android aplikacji. Użytkownik może zostać poproszony o określenie AVD, jeśli nie są już otwarte.

Szybsze, można użyć Virtual Machine Acceleration Aby poprawić szybkość realizacji. Wiele nowoczesnych procesorów dostarcza rozszerzeń do bardziej skutecznie wykonać maszyn wirtualnych. Przed próbą użycia tego typu przyspieszenia, trzeba określić, czy obecny system rozwoju CPU, obsługuje jeden następujące technologie wirtualizacji:

Technologia wirtualizacji Intel (VT-x, vmx) → Intel VT-x obsługiwane procesory lista
AMD Virtualization (AMD-V, SVM), obsługiwana tylko dla Linuksa (od maja 2006 r., obejmuje wszystkie procesory AMD AMD-V, z wyjątkiem Sempron).

Innym sposobem, aby dowiedzieć się, jeśli twój procesor Intel wspiera technologię VT-x, to wykonując Intel Processor Identification Utility , dla Windows można go pobrać z Centrum pobieraniaIntel, lub można użyć Narzędzia booteable, który jestOS Independent.

Po instalacji i wykonać Intel Processor Identification Utility przez Windows, pojawi się następujące okno, aby sprawdzić, czy twój procesor obsługuje technologie wirtualizacji:

Aby przyspieszyć emulator, musisz pobrać i zainstalować jeden lub więcej Intel x86 Atom obrazów systemu, jak równieżIntel Hardware Accelerated Execution Manager (HAXM).

Otwórz Menedżera SDK Androida i wybierz Intel x86 Atom obraz systemu, niezależnie od wersji, którą chcesz przetestować. Następnie przejdź do Extras i wybierz Intel x86 Emulator Accelerator (HAXM) i zainstalować te pakiety:

Po pobraniu uruchomić instalator Intel, który jest dostępny w twój Android SDK w extras/intel/Hardware_Accelerated_Execution_Manager . Uwaga: If you have any problems installing the package, you can find more information and step by step guidance check this artykuł Intel .

Zainstaluj jeden lub więcej Intel x86 Atom obrazów systemu, jak również Intel Hardware Accelerated Execution Manager , dostępne w ramach dodatków.
Biegać ten rata Intel, który jest dostępny w twój Android SDK wextras/intel/Hardware_Accelerated_Execution_Manager.
Tworzenie nowych AVD z miejsce docelowe ustawić obraz Intel.
Podczas uruchamiania emulatora, upewnij się, nie są bez komunikatów o błędach, wskazując błąd ładowania modułów HAX.

Uruchamianie na urządzeniu

Push aplikacja bezpośrednio do urządzenia, upewnij się, że debugowanie USB jest włączona w urządzeniu, zgodnie z opisem na Android Developer witrynyi używać mini kabla USB do podłączenia go do systemu.

Za pomocą tego polecenia CLI push aplikacja do urządzenia:

    $ cordova uruchomić Androida

.. .albo używać ten interfejs powłoki skoncentrowanych na Android:

    $ /path/to/project/cordova/run--urządzenia

Z nie flagi określone run polecenia wykrywa podłączone urządzenie, lub aktualnie uruchomionego emulatora, jeśli nie zostanie znaleziony, w przeciwnym razie prosi, aby określić emulator.

Aby uruchomić aplikację z w Eclipse, kliknij prawym przyciskiem myszy projekt i wybierz Uruchom jako → Android aplikacji.

Inne polecenia

Następujące generuje szczegółowy dziennik aplikacji, jak to działa:

    $ /path/to/project/cordova/log C:\path\to\project\cordova\log.bat

Następujące czyści pliki projektu:

    $ /path/to/project/cordova/clean C:\path\to\project\cordova\clean.bat