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
Od wersji 3.0 naprzód Cordova implementuje wszystkie urządzenia API jako wtyczki i pozostawia je wyłączone domyślnie. Wspiera on także dwa różne sposoby, aby dodać i usunąć wtyczki, zależnie od wybranej pracy omówione w przeglądzie:
Jeśli używasz przepływu pracy między platformami, możesz użyć cordova CLI użyteczność wobec dodać wtyczki, jak opisano w interfejs wiersza poleceń. CLI modyfikuje wtyczki dla wszystkich platform określony na raz.
Jeśli używasz pracy zorientowane na platformie, używasz Plugman interfejs wiersza poleceń niższego poziomu, oddzielnie dla każdej platformy docelowej.
Ta sekcja zawiera narzędzie Plugman szczegóły. Aby uzyskać więcej informacji na temat spożywania Plugman jako węzeł moduł lub modyfikowania kodu źródłowego Zobacz plik README w repozytorium.
Aby zainstalować plugman, musi mieć węzła zainstalowane na komputerze. Następnie można uruchomić następujące polecenie z gdziekolwiek w środowisku zainstalować plugman na całym świecie, tak, że jest dostępny z dowolnego katalogu:
$ npm install -g plugman
Musi także mieć git na swoje PATH Aby móc zainstalować wtyczki bezpośrednio z git zdalnych adresów URL.
Wskazówka: Jeśli stwierdzisz, że po zainstalowaniu plugman z npm jesteś jeszcze w stanie uruchomić każdy plugman poleceń, upewnij się, że dodałeś /npm/ katalogu na swojePATH.
Uwaga: można pominąć ten krok, jeśli nie chcesz zatruwają swoje globalne npm nazw instalując Plugman na całym świecie. Jeśli jest to przypadek, a następnie podczas tworzenia projektu Cordova z powłoka narzędzia, będzie node_modules katalogu wewnątrz projektu, który zawiera Plugman. Ponieważ zrobił nie rata globalnie, musisz wywołać node dla każdego polecenia Plugman, na przykład node ./node_modules/plugman/main.js -version . Z resztą ten przewodnik zakłada, że można mieć zainstalowany Plugman na całym świecie, co oznacza, że można go wywołać tylkoplugman.
Zanim będzie można użyć Plugman, należy utworzyć projekt Cordova. Można to zrobić z interfejsu wiersza polecenia lub z dolnej skryptów powłoki poziom. Instrukcje dotyczące używania skryptów powłoki do tworzenia projektu znajdują się w wielu przewodnikach “Narzędzia wiersza polecenia” wymienionych na stronie platformy przewodników.
Skoro masz rata Plugman i stworzyli projekt Cordova, można rozpocząć Dodawanie pluginów na platformie z:
$ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
Przy użyciu minimalnych parametrów, to polecenie instaluje plugin do projektu cordova. Należy określić lokalizację projektu platformy i cordova do tej platformy. Również należy określić plugin, z różnymi --plugin parametr tworzy się:
name: Nazwa katalogu gdzie istnieje zawartość wtyczki. To musi być istniejący katalog pod --plugins_dir ścieżki (patrz poniżej więcej informacji) lub pluginu w rejestrze Cordova.url: Adres URL zaczynając od https:// lub git: / /, wskazujące na repozytorium git ważne, że jest clonable i zawiera plugin.xml pliku. Zawartość repozytorium mogłoby być skopiowane w--plugins_dir.path: Ścieżka do katalogu, który zawiera prawidłowe plugin, który zawiera plugin.xml pliku. Zawartość tej ścieżki zostaną skopiowane do--plugins_dir.Inne parametry:
--plugins_dirDomyślnie <project>/cordova/plugins , ale można być dowolnego katalogu zawierającego podkatalog dla każdego pobrania plugin.--wwwustawienia domyślne do projektu www lokalizację folderu, ale może być dowolny katalog, który ma być używany jako cordova projektu aplikacji sieci web aktywów.--variablepozwala określić pewne zmienne w czasie instalacji, niezbędne dla niektórych wtyczek wymagających API klucze lub innych niestandardowych, zdefiniowanych przez użytkownika parametrów. Zobacz specyfikację wtyczki dla więcej informacji.Aby odinstalować plugin, po prostu przekazać --uninstall flagi i podać identyfikator plugin
$ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
Plugman oferuje pomoc globalne polecenia, które mogą pomóc, jeśli utkniesz lub występują problemy. Spowoduje to wyświetlenie listy wszystkich dostępnych poleceń Plugman i ich składni:
plugman -help plugman # same as above
Uwaga: plugman -help mogą wykazywać pewne dodatkowe polecenia związane z rejestru. Te polecenia są dla programistów wtyczki i nie mogą być realizowane na trzeciej plugin rejestrów.
Można również dołączyć --debug|-d Flaga na wszelkie Plugman polecenia do uruchamiania tego polecenia w trybie informacji pełnej, które będą wyświetlane komunikaty debugowania wewnętrznego, jak one są emitowane i może pomóc śledzić problemy, takie jak brakujące pliki.
# Adding Android battery-status plugin to "myProject": plugman -d --platform android --project myProject --plugin cordova-plugin-battery-status
Wreszcie, można użyć --version|-v flagi, aby sprawdzić, która wersja Plugman, którego używasz.
plugman -v
Istnieje wiele plugman poleceń, które mogą być używane do interakcji z rejestru Plugin. Należy pamiętać, że te komendy wpisywać do rejestru specyficzne dla rejestru plugin plugins.cordova.io i nie mogą być wykonywane przez rejestry firm plugin.
Plugman służy do przeszukiwania rejestru wtyczki plugin ID, które odpowiadają danym spacjami listę słów kluczowych.
plugman search <plugin keywords>
Można uzyskać lub ustawić adres URL bieżącego rejestru plugin który jest przy użyciu plugman. Zazwyczaj należy pozostawić ten zestaw w http://registry.cordova.io, chyba że chcesz użyć rejestru plugin stron trzecich.
plugman config set registry <url-to-registry> plugman config get registry
Można uzyskać informacje o wszelkich szczególnych plugin przechowywane w repozytorium wtyczki z:
plugman info <id>
To będzie kontakt z rejestru plugin i pobrać informacje takie jak numer wersji wtyczki.
Poniższe przykłady pokazują jak dodac pluginy, w razie potrzeby, tak, że każdy Cordova API można używać w projekcie nadal działać po uaktualnieniu do wersji 3.0. Dla każdego polecenia trzeba wybierz docelową platformę i odwołać katalogu projektu platformy.
cordova-plugin-battery-status
plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-battery-status
cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-camera
cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-console
cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-contacts
cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device
cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device-motion
cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device-orientation
cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-dialogs
cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-file
cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-file-transfer
cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-geolocation
cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-globalization
cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-inappbrowser
cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-media
cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-media-capture
cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-network-information
cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-splashscreen
cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-vibration