Správa modulů plug-in pro aplikace vytvořené s nástroji Visual Studio Tools for Apache Cordova

Článek
06/14/2015

Tento článek odkazuje na Visual Studio Tools for Apache Cordova, což je předběžná verze softwaru. Popisované funkce jsou ve verzi Preview a můžou se změnit. Verzi Preview si můžete stáhnout z webu Microsoft Download Center.

Používá Apache Cordova moduly plug-in poskytnout přístup k funkcím nativní zařízení, které nejsou k dispozici jednoduché webové aplikace, jako je například přístup k systému souborů.Modul plug-in je knihovna Cordova napříč platformami, který přistupuje k nativních schopností kódu a zařízení prostřednictvím rozhraní jazyka JavaScript.V případě potřeby, modul plug-in také aktualizuje manifest platformy chcete povolit funkce pro zařízení.Ne všechny moduly plug-in jsou podporovány nebo potřeby na všech platformách zařízení.

Pomocí souboru config.xml Cordova můžete povolit moduly plug-in.Visual Studio poskytuje způsoby, jak aktualizovat tento soubor pomocí návrháře konfigurace.Chcete-li spravovat moduly plug-in ve vaší aplikaci Cordova:

Pomocí nástroje Návrhář konfigurace sady Visual Studio k modul plug-in přidat ze základní nastavit Cordova moduly plug-in nebo chcete-li přidat vlastní modul plug-in
Použít konfiguraci designer, aktualizovat a modul plug-in.
Upravit config.xml k zadat parametry modul plug-in.
Rozšíření nebo vytvořit vlastní modul plug-in

[!POZNÁMKA]

Moduly plug-in jádro, která je k dispozici v Návrháři konfigurace naleznete v tématu seznam dostupné moduly plug-in.Další informace o moduly plug-in naleznete v tématu Cordova config.xml dokumentace.

Přidání modulu plug-in

Pomocí sady Visual Studio můžete přidat a modul plug-in Cordova jádro nebo vytvořit vlastní modul plug-in.Další moduly plug-in můžete také odkazovat z registru Cordova úpravou config.xml.Při vytváření vašeho řešení, je nainstalován modul plug-in z registru Cordova.

Modul plug-in přidat v Návrháři konfigurace sady Visual Studio

V Průzkumníku řešení otevřete místní nabídku pro soubor config.xml a zvolte otevřete nebo Návrhář zobrazení.
V Návrháři konfigurace, zvolte moduly plug-in karty.
Vyberte typ modulu plug-in, který chcete povolit ve vaší aplikaci (buď jádro nebo vlastní).(Viz seznam dostupné moduly plug-in.)
- Chcete-li přidat a základní modul plug-in, vyberte modul plug-in a zvolte přidat.
- Chcete-li přidat vlastní modul plug-in, zadejte místní nebo Git jako zdroj a poté zadejte umístění procházení nebo zadáním úložiště Git, jak je uvedeno.
  
  Například, zde je úložiště pro PushPlugin: https://github.com/phonegap-build/PushPlugin.git
Následující obrázek ukazuje výběr a základní modul plug-in v Návrháři konfigurace.

Následující obrázek ukazuje, jak přidat vlastní modul plug-in z úložiště Git v Návrháři konfigurace.
Když přidáte modul plug-in, Visual Studio také provede změny souboru config.xml.

Další informace o úpravu config.xml, naleznete Cordova config.xml dokumentace.

Přidáte-li vytvořit vlastní modul plug-in, Visual Studio také přidá strukturu modul plug-in složku a soubor do projektu moduly plug-in složky.Soubory důležité modul plug-in patří: plugin.xml, modul plug-in src složku a složku www modul plug-in.

Chcete-li odebrat a modul plug-in, najít modul plug-in v Návrháři konfigurace a zvolte odebrat.

Psaní kódu pro konkrétní modul plug-in, naleznete referenční dokumentace rozhraní API Cordova.

Probíhá aktualizace modulu plug-in

Pomocí návrháře konfigurace k aktualizaci a modul plug-in na novější verzi.Můžete aktualizovat všechny modul plug-in pomocí umístění zdroje Git nebo, je-li stáhnout a modul plug-in procházením do místní složky z Návrháře konfigurace.

Cordova moduly plug-in registru poskytuje informace o verzích jiný modul plug-in.

Konfigurace parametrů modul plug-in

Po přidání modulu plug-in pomocí návrháře konfigurace, můžete konfigurovat parametry úpravou souboru config.xml (vyberte zobrazení kódu z místní nabídky pro config.xml).

Můžete například nakonfigurovat modul plug-in sítě Facebook, můžete upravit následující parametry v souboru config.xml.

<vs:plugin name="com.phonegap.plugins.facebookconnect" version="0.8.1">
    <param name="APP_ID" value="12345678" />
    <param name="APP_NAME" value="My Facebook App" />
</vs:plugin>

Tato akce nemá stejný výsledek jako následujícího příkazu z příkazového řádku (je-li nebyly pomocí sady Visual Studio):

cordova plugin add https://github/com/Wizcorp/phonegap-facebook-plugin.git --variable APP_ID="12345678" –variable APP_NAME="My Facebook App"

Rozšíření o vlastní modul plug-in

V některých případech vlastní moduly plug-in v registru Cordova nemusí nesplňuje všechny požadavky na aplikace a můžete rozšířit a modul plug-in nebo vytvořit vlastní modul plug-in.Můžete například potřebujete-li přesměrování zpracování náročné funkcí, které mají nativního kódu, zveřejnit nové možnosti zařízení k aplikaci, nebo použít opravu na existující modul plug-in, který chcete raději není veřejně verze, můžete rozšířit nebo vytvořit a modul plug-in.Můžete vyhledat další informace o vytváření vlastních modulů plug-in v modul plug-in Průvodce vývoj v dokumentaci Cordova.

Pokud je nutné rozšířit vaší aplikace pomocí vlastní modul plug-in, nejprve zkontrolujte modul plug-in registru a použijte kód, který ostatním uživatelům jste napsali.Je-li existující plug-in blízko vše, co potřebujete, stáhnout, zdokonalení a poté odeslat tyto změny na původní autor.Toto je skvěle poskytováním zpět komunity Cordova a usnadňují pro ostatní uživatele k řešení podobných potíží.

Nainstalujte vlastní modul plug-in pomocí návrháře konfigurace.Je-li soubor plugin.xml www složku ve stromu složky projektu, požadované JavaScript soubory ze složky www modul plug-in budou automaticky načteny za běhu.Nemusíte odkazují na tyto soubory ze souboru HTML.Můžete také nastavit zarážky v rámci tyto soubory s kódem, v případě potřeby.Proces sestavení zkompiluje také všechny soubory specifické pro platformu ve složce src.

Seznam modulů plug-in, které jsou k dispozici v Návrháři konfigurace

Následující moduly plug-in jsou k dispozici, pomocí návrháře konfigurace:

Výsledného zrychlení / pohybu zařízení (org.apache.cordova.device pohybu)

Poskytuje přístup k snímač pohybu, který zjistí změny v pohybu relativní vzhledem k zařízení orientace.
Klient služby Azure Mobile (com.msopentech.azure mobilní služby)

Přidá příslušné klientské knihovny mobilních služeb Azure do své aplikace pro každou platformu a umožní svou aplikaci k synchronizaci obsahu s instancí mobilních služeb Azure.
Stav baterie (Android, iOS, Windows Phone 8) (org.apache.cordova.battery stav)

Umožňuje aplikaci pro zpracování události, která je vyvolána při nákladů, která je k dispozici v baterie zvětší nebo zmenší o alespoň 1 procent nebo, když je připojen nebo odpojen od napájení výstupu zařízení.
Fotoaparát (org.apache.cordova.camera)

Umožňuje vaše aplikace má provést obrázky pomocí výchozí aplikace kamery v zařízení.
Kompas (org.apache.cordova.device orientaci)

Poskytuje přístup k senzoru, který zjistí směr nebo záhlaví zařízení, podle které způsobem zařízení je aktivní.
Připojení (org.apache.cordova.network informace)

Umožňuje aplikaci k určení stavu připojení k síti zařízení a typy sítí, zařízení je připojeno k.
Konzola (org.apache.cordova.console)

Poskytuje jinou implementaci console.log (pro použití jako řešení pro console.log problémy).
Kontakty (org.apache.cordova.contacts)

Poskytuje přístup k databázi kontaktů v zařízení.Svou aplikaci můžete najít, přidat nebo odebrat kontakty.
Zařízení (org.apache.cordova.device)

Poskytuje přístup k informacím o hardwaru a softwaru zařízení.Například to může být číslo modelu nebo platformy zařízení.
Dialogová okna / oznámení (org.apache.cordova.dialogs)

Umožňuje aplikaci do dialogová okna zobrazit.
Systém souborů (org.apache.cordova.file)

Umožňuje aplikaci pro čtení, zápisu a navigace v systému souborů v zařízení.
Přenos souborů (org.apache.cordova.file přenosu)

Umožňuje vaše aplikace k ukládání nebo stahování souborů, chcete-li a ze serveru.
Zeměpisná poloha (org.apache.cordova.geolocation)

Poskytuje informace o umístění v zařízení, například zeměpisnou šířku a délku.
Globalization (org.apache.cordova.globalization)

Umožňuje aplikaci k získání informací o národní prostředí a časového pásma uživatele a poté provádět operace, které jsou specifické pro dané národní prostředí časového pásma.
InAppBrowser (org.apache.cordova.inappbrowser)

Umožňuje aplikaci do hostovat ve webovém prohlížeči a poté provádět akce v reakci na události související s protokolem prohlížeče, jako je například vkládání šablon stylů CSS do okna prohlížeče při načtení stránky.

[!POZNÁMKA]

V současné době připojování ladicí program ke aplikace pro iOS, které používají modul plug-in InAppBrowser není podporována.Modul plug-in mobilních služeb Azure používá modul plug-in InAppBrowser a je ovlivněn toto omezení.
Média (org.apache.cordova.media)

Umožňuje aplikaci k přehrávání a nahrávání zvukové soubory pomocí aplikace v zařízení výchozí.
Zachycení Media (org.apache.cordova.media zachycení)

Poskytuje přístup k zvuku a obrázku a možnosti záznam videa v zařízení.
SplashScreen (org.apache.cordova.splashscreen)

Umožňuje zobrazit a skrýt jeho úvodní obrazovka aplikace.
Vibrace (org.apache.cordova.vibration)

Umožňuje aplikaci vibrovat zařízení.
WebSQL Polyfill (Windows, Windows Phone 8) (com.msopentech.websql)

Povolí WebSQL na všech platformách přidáním WebSQL funkce pro svou aplikaci v systému Windows a Windows Phone 8.