Nie jest to najnowsza wersja dokumentacji! Click here for the latest released version.

Android Shell narzędzia Przewodnik

Ten przewodnik pokazuje jak użyć zestawu Cordova w skoncentrowanych na platformie powłoka narzędzia do opracowania aplikacji Android. Ta ścieżka rozwoju, omówione w przeglądzie, może zaoferować większy wachlarz możliwości rozwoju niż opisane w interfejs wiersza polecenia narzędzia CLI przekreślać platforma. Na przykład trzeba użyć narzędzia powłoki podczas wdrażania niestandardowego widoku sieci Web Cordova obok rodzimych komponentów. Przed użyciem albo ścieżki rozwoju, należy najpierw skonfigurować Android SDK środowiska zgodnie z opisem w podręczniku platformy Android.

Aby włączyć narzędzia powłoki dla systemu Android, Pobierz Cordova z cordova.apache.org. Pobierz za darmo zawiera osobne Archiwum dla każdej platformy. Rozwiń każdy chcesz kierować, android w tym przypadku. Odpowiednich narzędzi są zazwyczaj dostępne w najwyższego poziomu bin katalogu, inaczej skonsultować się w pliku README dla bardziej szczegółowe wskazówki.

Te narzędzia umożliwiają 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.

Tworzenie projektu

Uruchom create polecenie, określając ścieżkę istniejącego projektu, identyfikator odwrotnej domeny styl pakiet i nazwa wyświetlana aplikacji. Oto składnia dla Windows i Mac/Linux:

    $ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName

    C:\>\path\to\cordova-android\bin\create.bat \path\to\project com.example.project_name ProjectName

Budowanie

Ta komenda czyści a następnie buduje projekt.

Debugowania, na Mac/Linux czy Windows:

    $ /path/to/project/cordova/build --debug

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

Wydanie, na Mac/Linux czy Windows:

    $ /path/to/project/cordova/build --release

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

Uruchamianie aplikacji

Komenda run akceptuje następujące opcjonalne parametry:

Wyszczególnienie celu. Zawiera --emulator, --device, lub --target=<targetID>.

Wyszczególnienie opcji budowania. Zawiera --debug, --release, lub --nobuild.

$ /path/to/project/cordova/run [Target] [Build]

C:\>\path\to\project\cordova\run.bat [Target] [Build]

Upewnij się, że można utworzyć co najmniej jeden Android urządzenia wirtualnego, inaczej zostanie wyświetlony monit, aby zrobić z android polecenia. Jeśli więcej niż jeden AVD jest dostępny jako cel, zostanie wyświetlony monit o wybranie jednej. Domyślnie run polecenia wykrywa podłączone urządzenie, lub aktualnie uruchomionego emulatora, jeśli urządzenie nie znajduje.

Podpisywanie aplikacji

Można przejrzeć Android app podpisania wymagania tutaj: http://developer.android.com/tools/publishing/app-signing.html

Do podpisania aplikacji, musisz następujące parametry:

Keystore ( --keystore ): ścieżka do pliku binarnego, który może zawierać zestaw kluczy.
Keystore hasła ( --storePassword ): do keystore hasła
Aliasu ( --alias ): identyfikator określenie klucza prywatnego do śpiewania.
Hasło ( --password ): hasło do klucza prywatnego określonego.
Rodzaju kluczy ( --keystoreType ): pkcs12, jks (domyślnie: automatyczne wykrywanie oparty na rozszerzenie pliku)

Parametry te mogą być określone za pomocą argumentów wiersza polecenia powyżej do build lub run skrypty.

Alternatywnie, można je określić w budować konfiguracji pliku (build.json) za pomocą ( --buildConfig ) argumentu. Oto przykład pliku konfiguracyjnego budować:

{
     "android": {
         "debug": {
             "keystore": "..\android.keystore",
             "storePassword": "android",
             "alias": "mykey1",
             "password" : "password",
             "keystoreType": ""
         },
         "release": {
             "keystore": "..\android.keystore",
             "storePassword": "",
             "alias": "mykey2",
             "password" : "password",
             "keystoreType": ""
         }
     }
 }

Do wydania podpisu, hasła mogą być wyłączone i budować system wyda się monit z prośbą o hasło.

Dostępna jest również obsługa mieszać i łączyć argumentów wiersza polecenia i parametry w pliku build.json. Wartości od argumentów wiersza polecenia otrzyma pierwszeństwo. Może to być przydatne do określania haseł w wierszu polecenia.

Rejestrowanie

    $ /path/to/project/cordova/log

    C:\>\path\to\project\cordova\log.bat

Czyszczenie

    $ /path/to/project/cordova/clean

    C:\>\path\to\project\cordova\clean.bat

Budynek z Gradle

Od cordova-android@4.0.0, projekt budowy przy użyciu Gradle. Aby uzyskać instrukcje dotyczące budynku z ANT odnoszą się do starszych wersji dokumentacji.

Gradle właściwości

Te Właściwości można ustawić aby dostosować ten budować:

cdvBuildMultipleApks (domyślnie: false)

Jeśli ta opcja jest ustawiona, a następnie wiele plików APK zostanie wygenerowany: jeden na rodzimych platformy obsługiwane przez biblioteka projektów (x 86, ramię, itp). Może to być ważne, jeśli twój projekt używa dużych bibliotek rodzimych, które drastycznie zwiększyć rozmiar wygenerowanego APK.

Jeśli nie zestaw, a następnie jeden APK zostanie wygenerowany które mogą być używane na wszystkich urządzeniach.
cdvVersionCode

Zastępuje versionCode, wAndroidManifest.xml
cdvReleaseSigningPropertiesFile (domyślnie: wydanie signing.properties)

Ścieżka do pliku *.Properties, zawierający podpisywanie informacji do wydania buduje. Plik powinien wyglądać tak:
```
storeFile=relative/path/to/keystore.p12
storePassword=SECRET1
storeType=pkcs12
keyAlias=DebugSigningKey
keyPassword=SECRET2
```
storePasswordi keyPassword są opcjonalne, a zostaniesz poproszony o pominięcie.
cdvDebugSigningPropertiesFile (domyślnie: debugowania signing.properties)

Tak samo jak cdvReleaseSigningPropertiesFile, ale dla debugowania buduje. Przydatne, gdy zachodzi potrzeba udostępnienia klucza podpisywania z innymi deweloperami.
cdvMinSdkVersion

Zastępuje wartość minSdkVersion w AndroidManifest.xml . Przydatne podczas tworzenia wielu APKs oparte na wersja SDK.
cdvBuildToolsVersion

Zastąpić automatycznie wykryć android.buildToolsVersion wartość.
cdvCompileSdkVersion

Zastąpić automatycznie wykryć android.compileSdkVersion wartość.

Rozszerzenie build.gradle

Jeśli chcesz dostosować build.gradle , raczej niż edytować bezpośrednio, należy utworzyć element członkowski równorzędny plik o nazwie build-extras.gradle . Ten plik zostaną uwzględnione przez głównego build.gradle kiedy obecny. Oto przykład:

# Example build-extras.gradle
# This file is included at the beginning of `build.gradle`
ext.cdvDebugSigningPropertiesFile = '../../android-debug-keys.properties'
# When set, this function allows code to run at the end of `build.gradle`
ext.postBuildExtras = {
    android.buildTypes.debug.applicationIdSuffix = '.debug'
}

Należy zauważyć, że wtyczki można również build-extras.gradle plików za pomocą:

<framework src="some.gradle" custom="true" type="gradleReference" />

Przykład budowy

export ORG_GRADLE_PROJECT_cdvMinSdkVersion=14
cordova build android -- --gradleArg=-PcdvBuildMultipleApks=true