You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/09/12 19:02:26 UTC
[14/50] [abbrv] docs commit: CB-4784 Fixing links by consistently
translating headings. Code fixes for ios plugin.md
CB-4784 Fixing links by consistently translating headings. Code fixes for ios plugin.md
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/ba7793a5
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/ba7793a5
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/ba7793a5
Branch: refs/heads/master
Commit: ba7793a5b89e8eaef3d15eaeeab3674814558557
Parents: b4e726e
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Sep 11 10:14:00 2013 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Sep 11 10:14:00 2013 -0400
----------------------------------------------------------------------
docs/es/edge/guide/cli/index.md | 45 ++++++-----
docs/es/edge/guide/platforms/ios/plugin.md | 78 +++++++++++++------
docs/fr/edge/guide/cli/index.md | 45 ++++++-----
docs/fr/edge/guide/overview/index.md | 2 +-
docs/fr/edge/guide/platforms/android/plugin.md | 2 +-
docs/fr/edge/guide/platforms/ios/plugin.md | 84 +++++++++++++++------
docs/it/edge/guide/platforms/android/plugin.md | 2 +-
docs/it/edge/guide/platforms/ios/plugin.md | 82 ++++++++++++++------
docs/ja/edge/guide/platforms/android/plugin.md | 2 +-
docs/ja/edge/guide/platforms/ios/plugin.md | 78 ++++++++++++++++---
docs/ko/edge/guide/platforms/android/plugin.md | 2 +-
docs/ko/edge/guide/platforms/ios/plugin.md | 82 ++++++++++++++------
docs/zh/edge/guide/platforms/android/plugin.md | 2 +-
docs/zh/edge/guide/platforms/ios/plugin.md | 78 ++++++++++++++++---
14 files changed, 432 insertions(+), 152 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/es/edge/guide/cli/index.md
----------------------------------------------------------------------
diff --git a/docs/es/edge/guide/cli/index.md b/docs/es/edge/guide/cli/index.md
index c99441c..7ee60c2 100644
--- a/docs/es/edge/guide/cli/index.md
+++ b/docs/es/edge/guide/cli/index.md
@@ -159,67 +159,76 @@ El `cordova plugin add` comando requiere especificar el repositorio para el cód
* Información básica del dispositivo (dispositivo API):
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
* Conexión de red y eventos de batería:
- $ cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
* Acelerómetro, brújula y geolocalización:
- $ cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
* Cámara, reproducción multimedia y captura:
- $ cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
* Acceder a archivos en el dispositivo o red (archivo API):
- $ cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
* Notificación mediante vibración o cuadro de diálogo:
- $ cordova plugin añade $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
* Contactos:
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
* Globalización:
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
* SplashScreen:
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
* Abrir nuevas ventanas del navegador (InAppBrowser):
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
* Consola de depuración:
- $ cordova plugin agregar https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git
Uso `plugin ls` (o `plugin list` , o `plugin` por sí mismo) ver actualmente instalado plugins. Cada muestra por su identificador:
- $ cordova plugin ls # o ' plugin' ['org.apache.cordova.core.console']
+ $ cordova plugin ls # or 'plugin list'
+ [ 'org.apache.cordova.core.console' ]
Para quitar un plugin, referirse a él por el mismo identificador que aparece en el listado. Por ejemplo, aquí es cómo le quita apoyo para una consola de depuración de una versión:
- $ cordova plugin rm org.apache.cordova.core.console $ cordova plugin quitar org.apache.cordova.core.console # mismo
+ $ cordova plugin rm org.apache.cordova.core.console
+ $ cordova plugin remove org.apache.cordova.core.console # same
Puede lote-quitar o agregar plugins por especificar más de un argumento para cada comando.
@@ -232,14 +241,14 @@ En cambio, el nivel superior `merges` Directorio ofrece un lugar para especifica
* Editar el `www/index.html` archivo, añadir un enlace a un archivo CSS adicional, `overrides.css` en este caso:
- < link rel = "stylesheet" type = "text/css" href="css/overrides.css" / >
+ <link rel="stylesheet" type="text/css" href="css/overrides.css" />
* Opcionalmente crear un vacío `www/css/overrides.css` archivo, que se aplicaría para todas las versiones no-Android, evitando un error de archivo que falta.
* Crear un `css` subdirectorio dentro de `merges/android` , luego añadir un correspondiente `overrides.css` archivo. Especificar CSS que reemplaza el tamaño de letra de 12 puntos por defecto especificado dentro de `www/css/index.css` , por ejemplo:
- cuerpo {font-tamaño: 14px;}
+ body { font-size:14px; }
Al reconstruir el proyecto, la versión para Android cuenta con el tamaño de fuente personalizada, mientras que otros permanecen inalterados.
@@ -250,18 +259,18 @@ También se puede utilizar `merges` para agregar archivos no presenten en el ori
Después de instalar el `cordova` utilidad, puede siempre actualizarlo a la versión más reciente ejecutando el siguiente comando:
- $ sudo npm actualizar cordova -g
+ $ sudo npm update -g cordova
Para instalar una versión específica, utilice esta sintaxis:
- $ sudo npm instalar cordova@3.0.0 -g
+ $ sudo npm install -g cordova@3.0.0
Ejecute `cordova -v` para ver la versión actualmente en ejecución. Ejecute el `npm
info` comando para obtener una lista más larga que incluye la versión actual junto con otros números de la versión disponible:
- $ npm información cordova
+ $ npm info cordova
Cordova 3.0 es la primera versión compatible con la interfaz de línea de comandos descrita en esta sección. Si actualiza desde una versión anterior a 3.0, tienes que crear un nuevo proyecto como se describió anteriormente, luego copie los activos de la mayor aplicación en el nivel superior `www` Directorio. En su caso, más detalles sobre la actualización a 3.0 están disponibles en las guías de la plataforma. Una vez que se actualiza a la `cordova` interfaz de línea de comandos y uso `npm update` para estar al día, los más lentos procedimientos descritos allí ya no son relevantes.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/es/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/es/edge/guide/platforms/ios/plugin.md b/docs/es/edge/guide/platforms/ios/plugin.md
index 8524ff6..326afb2 100644
--- a/docs/es/edge/guide/platforms/ios/plugin.md
+++ b/docs/es/edge/guide/platforms/ios/plugin.md
@@ -24,7 +24,7 @@ Cada clase plugin debe estar registrado como un `<feature>` de la etiqueta en el
La porción de JavaScript de un plugin utiliza siempre el `cordova.exec` método como sigue:
- exec (<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
Esto mariscales una solicitud de la `UIWebView` al lado de iOS nativas, más o menos hirviendo a llamar al método de `acción` en la clase de `servicio`, con los argumentos pasados en la matriz de `args`.
@@ -42,7 +42,10 @@ La función `name` atributo debe coincidir con lo que usas en JavaScript `exec`
Para la vida de cada uno se crea una instancia de un objeto plugin `UIWebView` . Plugins no se instancian hasta que primero se hace referencia mediante una llamada desde JavaScript, a menos que `<param>` con un `onload` `name` atributo se establece en `"true"` en `config.xml` . Por ejemplo:
- < nombre de la función = "Echo" >< param nombre = valor "ios-paquete" = "Echo" / >< param nombre = valor "onload" = "true" / >< / característica >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
No hay *ningún* señalado a inicializador de plugins. Por el contrario, debe usar plugins el `pluginInitialize` método para su lógica puesta en marcha.
@@ -55,12 +58,17 @@ Tenemos fuego JavaScript apagado una solicitud plugin nativo al lado. Tenemos el
Lo obtiene despachó al plugin vía la función de JavaScript `exec` se pasa al método de `action` de la clase Plugin correspondiente. Un método de plugin tiene esta firma:
- -comando:(CDVInvokedUrlCommand*) MiMetodo (void) {CDVPluginResult * pluginResult = nil;
- NSString * myarg = [command.arguments objectAtIndex:0];
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
- Si (myarg! = nil) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
- } más {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg era nula"];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}
@@ -78,7 +86,7 @@ Lo obtiene despachó al plugin vía la función de JavaScript `exec` se pasa al
Usando CDVPluginResult puede volver una variedad de tipos de resultados a su segunda prueba de JavaScript, utilizando métodos de la clase que se parecen:
- + (CDVPluginResult *) resultWithStatus: (CDVCommandStatus) statusOrdinal messageAs...
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
Puede crear `String`, `Int`, `Double`, `Bool`, `Array`, `Dictionary`, `ArrayBuffer` y `Multipart` tipos. O, no conecte ningún argumento (sólo enviar un estado). O, devolverá un Error. Incluso puede elegir no enviar ningún resultado del plugin, en cuyo caso la devolución de llamada no se dispara.
@@ -93,20 +101,45 @@ Puede crear `String`, `Int`, `Double`, `Bool`, `Array`, `Dictionary`, `ArrayBuff
Nos gustaría añadir lo siguiente al proyecto de `config.xml` archivo:
- < nombre de la función = "Eco" >< nombre param = "ios-paquete" value = "Eco" / >< / característica >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
Entonces nos gustaría añadir los siguientes archivos ( `Echo.h` y `Echo.m` ) a la carpeta Plugins dentro de la carpeta de la aplicación Cordova-iOS:
- / *** Echo.h Cordova Plugin encabezado *** / #import < Cordova/CDV.h > @interface Echo: CDVPlugin - comando de:(CDVInvokedUrlCommand*) echo (void);
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDV.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
- @end / *** Echo.m Cordova Plugin aplicación *** / #import "Echo.h" #import < Cordova/CDV.h > @implementation Eco - comando de:(CDVInvokedUrlCommand*) echo (void) {CDVPluginResult * pluginResult = nil;
- NSString * Eco = [command.arguments objectAtIndex:0];
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
- Si (Eco! = nil & & [Eco longitud] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
- } más {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
- } @end
+ @end
Echemos un vistazo al código. En la parte superior tenemos todas las necesarias importaciones de Córdoba. Nuestra clase se extiende desde `CDVPlugin` (muy importante).
@@ -121,11 +154,14 @@ Finalmente, enviamos el resultado a `self.commandDelegate` , que ejecuta el `exe
Plugin métodos se ejecutan en el mismo subproceso como la interfaz de usuario. Si tu plugin requiere una gran cantidad de procesamiento o requiere una llamada de bloquea, debe utilizar un subproceso de fondo. Por ejemplo:
- -comando:(CDVInvokedUrlCommand*) myPluginMethod (void) {/ / Check command.arguments aquí.
- [self.commandDelegate runInBackground: ^ {NSString * capacidad de carga = nil;
- / / Algunos bloqueando lógica...
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
- / / El método sendPluginResult es segura para subprocesos.
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
[self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}];
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/fr/edge/guide/cli/index.md
----------------------------------------------------------------------
diff --git a/docs/fr/edge/guide/cli/index.md b/docs/fr/edge/guide/cli/index.md
index 5c7e2b1..1870e5e 100644
--- a/docs/fr/edge/guide/cli/index.md
+++ b/docs/fr/edge/guide/cli/index.md
@@ -159,67 +159,76 @@ Le `cordova plugin add` commande nécessite vous permet de spécifier le référ
* Informations de base périphérique (Device API) :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
* Connexion réseau et événements de la batterie :
- $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
* Accéléromètre, boussole et géolocalisation :
- $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
* Appareil photo, lecture et Capture :
- $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git $ cordova plugin ajoute $ https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
* Accéder aux fichiers sur un périphérique réseau (fichier API) :
- $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git $ cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
* Notification via la boîte de dialogue ou de vibration :
- $ cordova plugin ajoute https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git $ cordova plugin ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
* Contacts :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
* Mondialisation :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
* SplashScreen :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
* Fenêtres ouvertes du navigateur nouvelle (InAppBrowser) :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
* Console de débogage :
- plugin cordova $ ajouter https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git
Utilisation `plugin ls` (ou `plugin list` , ou `plugin` en soi) à Découvre actuellement les plugins installés. Chacun affiche par son identificateur :
- $ cordova plugin ls # ou « list plugin » ['org.apache.cordova.core.console']
+ $ cordova plugin ls # or 'plugin list'
+ [ 'org.apache.cordova.core.console' ]
Pour supprimer un plugin, faire référence à elle par le même identificateur qui apparaît dans la liste. Par exemple, voici comment vous enlèverait le soutien pour une console de débogage d'une version :
- $ cordova plugin rm org.apache.cordova.core.console $ cordova plugin supprimer org.apache.cordova.core.console # même
+ $ cordova plugin rm org.apache.cordova.core.console
+ $ cordova plugin remove org.apache.cordova.core.console # same
Vous pouvez lot-supprimer ou ajouter des plugins en spécifiant plusieurs arguments pour chaque commande.
@@ -232,14 +241,14 @@ Au lieu de cela, le niveau supérieur `merges` répertoire offre un endroit pour
* Modifier la `www/index.html` fichier, en ajoutant un lien vers un fichier CSS supplémentaire, `overrides.css` dans ce cas :
- < link rel = "stylesheet" type = "text/css" href="css/overrides.css" / >
+ <link rel="stylesheet" type="text/css" href="css/overrides.css" />
* Créer éventuellement un vide `www/css/overrides.css` fichier, qui s'applique pour toutes les versions non-Android, empêchant une erreur de fichier manquant.
* Créer un `css` sous-répertoire dans `merges/android` , puis ajoutez un correspondant `overrides.css` fichier. Spécifier CSS qui remplace la taille de police de 12 points par défaut spécifiée dans `www/css/index.css` , par exemple :
- Body {font-size : 14px;}
+ body { font-size:14px; }
Lorsque vous régénérez le projet, la version Android dispose de la taille de police personnalisée, tandis que d'autres restent inchangés.
@@ -250,18 +259,18 @@ Vous pouvez également utiliser `merges` pour ajouter des fichiers non présents
Après avoir installé la `cordova` utilitaire, vous pouvez toujours mettre à jour elle vers la dernière version en exécutant la commande suivante :
- $ sudo NGP update cordova -g
+ $ sudo npm update -g cordova
Utilisez cette syntaxe pour installer une version spécifique :
- $ sudo NGP installer -g cordova@3.0.0
+ $ sudo npm install -g cordova@3.0.0
Exécutez `cordova -v` pour voir la version en cours d'exécution. Exécutez le `npm
info` commande pour obtenir une liste plus longue qui inclut la version actuelle ainsi que d'autres numéros de version disponible :
- $ NGP info cordova
+ $ npm info cordova
Cordova 3.0 est la première version à supporter l'interface de ligne de commande décrite dans cette section. Si vous mettez à jour depuis une version antérieure à 3.0, vous devez créer un nouveau projet, tel que décrit ci-dessus, puis copiez les actifs les plus âgés de l'application dans le niveau supérieur `www` répertoire. Le cas échéant, plus amples détails sur la mise à niveau vers 3.0 sont disponibles dans les Guides de la plate-forme. Une fois que vous mettez à niveau vers le `cordova` Command-line interface et utilisation `npm update` pour rester à jour, les plus longues procédures décrits là ne sont plus pertinentes.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/fr/edge/guide/overview/index.md
----------------------------------------------------------------------
diff --git a/docs/fr/edge/guide/overview/index.md b/docs/fr/edge/guide/overview/index.md
index afda3ea..7d7e6aa 100644
--- a/docs/fr/edge/guide/overview/index.md
+++ b/docs/fr/edge/guide/overview/index.md
@@ -14,7 +14,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
---
-# Vue d'ensemble
+# Présentation
Cordova est un framework de développement mobile open-source. Il vous permet d'utiliser des technologies web standard tels que HTML5, CSS3 et JavaScript pour le développement multi-plateforme, en évitant de langue native development chaque mobile platforms. Les applications s'exécutent dans les wrappers ciblées pour chaque plate-forme et s'appuient sur les liaisons conforme aux normes d'API pour accéder aux capteurs de chaque appareil, les données et état du réseau.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/fr/edge/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/docs/fr/edge/guide/platforms/android/plugin.md b/docs/fr/edge/guide/platforms/android/plugin.md
index 87eae49..a316196 100644
--- a/docs/fr/edge/guide/platforms/android/plugin.md
+++ b/docs/fr/edge/guide/platforms/android/plugin.md
@@ -24,7 +24,7 @@ Un plugin est composé d'au moins une classe Java qui étend la `CordovaPlugin`
La partie JavaScript d'un plugin utilise toujours la `cordova.exec` méthode comme suit :
- exec (<successFunction>, <failFunction>, <service>, <action>, [<args>]) ;
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
Cela marshale une demande de la WebView vers le côté natif Android, plus ou moins bouillante vers le bas pour appeler le `action` méthode sur la `service` classe, avec les arguments passés à la `args` tableau.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/fr/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/fr/edge/guide/platforms/ios/plugin.md b/docs/fr/edge/guide/platforms/ios/plugin.md
index a48befe..c44aabb 100644
--- a/docs/fr/edge/guide/platforms/ios/plugin.md
+++ b/docs/fr/edge/guide/platforms/ios/plugin.md
@@ -24,14 +24,16 @@ Chaque classe de plugin doit être enregistré comme une `<feature>` tag dans le
La partie JavaScript d'un plugin utilise toujours la `cordova.exec` méthode comme suit :
- exec (<successFunction>, <failFunction>, <service>, <action>, [<args>]) ;
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
Cela marshale une demande de la `UIWebView` vers le côté natif iOS, plus ou moins bouillant vers le bas pour appeler le `action` méthode sur la `service` classe, avec les arguments passés à la `args` tableau.
Précisez le plugin comme un `<feature>` tag dans le projet de votre application Cordova-iOS `config.xml` fichier.
- < nom de la fonction = « LocalStorage » >< param name = « ios-paquet » value = « CDVLocalStorage » / >< / fiction >
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
La fonction `name` attribut doit correspondre à ce que vous utilisez dans le JavaScript `exec` call `service` paramètre et le `value` attribut doit correspondre au nom de classe d'Objective-C du plugin. `<param name>`Je serais toujours `"ios-package"` . Si vous ne suivez pas cette configuration, le plugin peut compiler mais ne sera pas atteignable par Cordova.
@@ -40,7 +42,10 @@ La fonction `name` attribut doit correspondre à ce que vous utilisez dans le Ja
Une seule instance d'un objet plugin est créée pour la vie de chaque `UIWebView` . Plugins ne sont pas instanciés jusqu'à ce qu'ils sont tout d'abord référencées par un appel de JavaScript, à moins que `<param>` avec un `onload` `name` attribut a la valeur `"true"` dans `config.xml` . Par exemple :
- < nom de la fonction = « Echo » >< param nom = valeur « ios-package » = « Echo » / >< param name = « onload » value = « true » / >< / fiction >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
Il y a *pas* désigné l'initialiseur de plugins. Plugins doivent plutôt utiliser la `pluginInitialize` méthode pour leur logique de démarrage.
@@ -53,12 +58,17 @@ Nous avons une demande de plugin pour le côté natif JavaScript feu. Nous avons
Ce qui obtient expédié vers le plugin via du JavaScript `exec` fonction passée dans la classe correspondante Plugin `action` méthode. Une méthode de plugin a cette signature :
- -commande de:(CDVInvokedUrlCommand*) de myMethod (void) {CDVPluginResult * pluginResult = nil ;
- NSString * myarg = [command.arguments objectAtIndex:0] ;
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
- Si (myarg! = nil) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK] ;
- } else {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg était null"] ;
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ;
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}
@@ -76,7 +86,7 @@ Ce qui obtient expédié vers le plugin via du JavaScript `exec` fonction passé
À l'aide de CDVPluginResult vous pouvez retourner une variété de types de résultats à vos rappels JavaScript, utilisant des méthodes de la classe qui ressemblent à :
- + ResultWithStatus (CDVPluginResult *): (CDVCommandStatus) statusOrdinal messageAs...
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
Vous pouvez créer des `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` , et `Multipart` types. Ou bien, ne joindre aucun argument (il suffit d'envoyer un État). Ou, renvoie une erreur. Vous pouvez même choisir ne pas envoyer n'importe quel résultat de plugin du tout, auquel cas le rappel ne se déclenche pas.
@@ -91,20 +101,45 @@ Vous pouvez créer des `String` , `Int` , `Double` , `Bool` , `Array` , `Diction
Nous aimerions ajouter ce qui suit pour le projet `config.xml` fichier :
- < nom de la fonction = « Echo » >< param name = « ios-paquet » value = « Echo » / >< / fiction >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
Puis nous aimerions ajouter les fichiers suivants ( `Echo.h` et `Echo.m` ) dans le dossier Plugins dans notre dossier de demande de Cordova-iOS :
- / *** Echo.h Cordova Plugin en-tête *** / #import < Cordova/CDV.h > @interface Echo : CDVPlugin - commande de (Sub) echo de:(CDVInvokedUrlCommand*) ;
+ /********* Echo.h Cordova Plugin Header *******/
- @end / *** Echo.m Cordova Plugin application *** / #import « Echo.h » #import < Cordova/CDV.h > @implementation Echo - commande de:(CDVInvokedUrlCommand*) d'echo (void) {CDVPluginResult * pluginResult = nil ;
- NSString * echo = [command.arguments objectAtIndex:0] ;
+ #import <Cordova/CDV.h>
- Si (écho! = nil & & [écho longueur] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo] ;
- } else {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR] ;
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ;
- } @end
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
Nous allons jeter un coup d'oeil sur le code. En haut, nous avons toutes les importations de Cordova nécessaires. Notre classe s'étend de `CDVPlugin` (très important).
@@ -119,12 +154,15 @@ Enfin, nous envoyer le résultat à `self.commandDelegate` , qui exécute le `ex
Méthodes plugin sont exécutées dans le même thread que l'interface utilisateur. Si votre plugin nécessite beaucoup de traitement ou nécessite un appel bloquant, vous devez utiliser un thread d'arrière-plan. Par exemple :
- -commande de:(CDVInvokedUrlCommand*) de myPluginMethod (void) {/ / Check command.arguments ici.
- [self.commandDelegate runInBackground: ^ {NSString * charge utile = nil ;
- / / Une logique de blocage...
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload] ;
- / / La méthode de sendPluginResult est thread-safe.
- [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ;
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}];
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/it/edge/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/docs/it/edge/guide/platforms/android/plugin.md b/docs/it/edge/guide/platforms/android/plugin.md
index 4370304..4c99354 100644
--- a/docs/it/edge/guide/platforms/android/plugin.md
+++ b/docs/it/edge/guide/platforms/android/plugin.md
@@ -24,7 +24,7 @@ Un plugin è costituito da almeno una classe Java che estende la `CordovaPlugin`
La parte di JavaScript di un plugin utilizza sempre il `cordova.exec` metodo come segue:
- exec (< successFunction >, < failFunction >, < servizio >, < azione >, [< args >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
Questo esegue il marshalling di una richiesta da WebView sul lato nativo Android, più o meno bollente giù a chiamare il `action` metodo sul `service` classe, con gli argomenti passati nella `args` matrice.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/it/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/it/edge/guide/platforms/ios/plugin.md b/docs/it/edge/guide/platforms/ios/plugin.md
index 4d775be..71473be 100644
--- a/docs/it/edge/guide/platforms/ios/plugin.md
+++ b/docs/it/edge/guide/platforms/ios/plugin.md
@@ -24,14 +24,16 @@ Ogni classe plugin deve essere registrato come un `<feature>` taggare nella `con
La parte di JavaScript di un plugin utilizza sempre il `cordova.exec` metodo come segue:
- exec (< successFunction >, < failFunction >, < servizio >, < azione >, [< args >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
Questo esegue il marshalling di una richiesta dalla `UIWebView` sul lato nativo di iOS, più o meno bollente fino a chiamare il `action` metodo sul `service` classe, con gli argomenti passati nella `args` matrice.
Specificare il plugin come un `<feature>` tag nel progetto dell'applicazione Cordova-iOS `config.xml` file.
- < nome funzione = "LocalStorage" >< param nome = valore "ios-pacchetto" = "CDVLocalStorage" / >< / caratteristica >
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
La caratteristica `name` attributo deve corrispondere a quello che si utilizza in JavaScript `exec` di chiamata `service` parametro e il `value` attributo deve corrispondere al nome della classe Objective-C del plugin. `<param name>`io dovrei essere sempre `"ios-package"` . Se non si segue questa impostazione, il plugin può compilare, ma non sarà raggiungibile da Cordova.
@@ -40,7 +42,10 @@ La caratteristica `name` attributo deve corrispondere a quello che si utilizza i
Viene creata un'istanza di un oggetto plugin per la vita di ogni `UIWebView` . Plugin non vengono create istanze fino a quando essi fanno riferimento in primo luogo una chiamata da JavaScript, a meno che non `<param>` con un `onload` `name` attributo è impostato su `"true"` in `config.xml` . Per esempio:
- < nome funzione = "Echo" >< param nome = valore "ios-pacchetto" = "Echo" / >< nome param = "onload" value = "true" / >< / caratteristica >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
Non c'è *nessun* designato inizializzatore per i plugin. Plugin necessario utilizzare invece il `pluginInitialize` metodo per la loro logica di avviamento.
@@ -53,12 +58,17 @@ Abbiamo JavaScript fuoco fuori una richiesta di plugin al lato nativo. Abbiamo i
Che cosa ottiene spedito al plugin tramite di JavaScript `exec` funzione viene passato la classe corrispondente Plugin `action` metodo. Un metodo di plugin ha questa firma:
- -comando:(CDVInvokedUrlCommand*) myMethod (void) {CDVPluginResult * pluginResult = nil;
- NSString * myarg = [command.arguments objectAtIndex: 0];
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
- Se (myarg! = nil) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
- } else {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg era null"];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}
@@ -76,7 +86,7 @@ Che cosa ottiene spedito al plugin tramite di JavaScript `exec` funzione viene p
Utilizzando CDVPluginResult è possibile restituire una varietà di tipi di risultato al vostro callback JavaScript, utilizzando i metodi della classe che sembrano:
- + (CDVPluginResult *) resultWithStatus: messageAs statusOrdinal (CDVCommandStatus)...
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
È possibile creare `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` , e `Multipart` tipi. O, non allegare eventuali argomenti (basta inviare uno status). O, per restituire un errore. Può anche scegliere di non inviare alcun risultato plugin a tutti, nel qual caso non viene generato il callback.
@@ -91,20 +101,45 @@ Utilizzando CDVPluginResult è possibile restituire una varietà di tipi di risu
Aggiungiamo i seguenti al progetto `config.xml` file:
- < nome funzione = "Echo" >< param nome = valore "ios-pacchetto" = "Echo" / >< / caratteristica >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
Poi aggiungiamo i seguenti file ( `Echo.h` e `Echo.m` ) nella cartella plugin all'interno della nostra cartella di applicazione di Cordova-iOS:
- / --- Echo.h Cordova Plugin intestazione * * * / Echo #import < Cordova/CDV.h > @interface: CDVPlugin - comando di:(CDVInvokedUrlCommand*) echo (void);
+ /********* Echo.h Cordova Plugin Header *******/
- @end / --- implementazione di Plugin Cordova Echo.m * * * / #import "Echo.h" #import < Cordova/CDV.h > @implementation Echo - comando di:(CDVInvokedUrlCommand*) echo (void) {CDVPluginResult * pluginResult = nil;
- NSString * echo = [command.arguments objectAtIndex: 0];
+ #import <Cordova/CDV.h>
- Se (eco! = nil & & [eco lunghezza] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
- } else {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
- } @end
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
Diamo un'occhiata al codice. In cima abbiamo tutte le necessarie importazioni di Cordova. La nostra classe si estende da `CDVPlugin` (molto importante).
@@ -119,11 +154,14 @@ Infine, inviamo il risultato di `self.commandDelegate` , che esegue il `exec` ca
Plugin metodi vengono eseguiti nello stesso thread come interfaccia utente. Se il tuo plugin richiede una grande quantità di elaborazione o richiede una chiamata di blocco, è necessario utilizzare un thread in background. Ad esempio:
- -comando:(CDVInvokedUrlCommand*) myPluginMethod (void) {/ / Check command.arguments qui.
- [self.commandDelegate runInBackground: ^ {NSString * carico utile = nil;
- / / Qualche logica di blocco...
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
- / / Il metodo sendPluginResult è thread-safe.
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
[self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}];
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/ja/edge/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/docs/ja/edge/guide/platforms/android/plugin.md b/docs/ja/edge/guide/platforms/android/plugin.md
index 6923b21..0c24091 100644
--- a/docs/ja/edge/guide/platforms/android/plugin.md
+++ b/docs/ja/edge/guide/platforms/android/plugin.md
@@ -24,7 +24,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
プラグインの JavaScript の部分を常に使用して、 `cordova.exec` メソッドは次のように。
- exec (< successFunction > < failFunction >, < サービス > < アクション > [< 引数 >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
これは、アンドロイド ネイティブ側には、もっとまたはより少なく通話にダウン沸騰、WebView から要求をマーシャ リングします、 `action` 法、 `service` に渡された引数を持つクラス、 `args` 配列。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/ja/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/ja/edge/guide/platforms/ios/plugin.md b/docs/ja/edge/guide/platforms/ios/plugin.md
index 3112774..a75f213 100644
--- a/docs/ja/edge/guide/platforms/ios/plugin.md
+++ b/docs/ja/edge/guide/platforms/ios/plugin.md
@@ -24,14 +24,16 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
プラグインの JavaScript の部分を常に使用して、 `cordova.exec` メソッドは次のように。
- exec (< successFunction > < failFunction >, < サービス > < アクション > [< 引数 >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
これから要求をマーシャ リングします、 `UIWebView` 、iOS ネイティブ側にもっとまたはより少なく通話にダウン沸騰、 `action` メソッド、 `service` に渡された引数を持つクラス、 `args` 配列。
指定のプラグインとして、 `<feature>` 、コルドバ iOS アプリケーションのプロジェクトのタグ `config.xml` ファイル。
- < 機能名 ="LocalStorage">< param の名前 = 値「ios パッケージ」="CDVLocalStorage"/></機能 >
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
機能は、 `name` 属性は、JavaScript で使用すると一致する必要があります `exec` コールの `service` パラメーターと、 `value` 属性は、プラグインの Objective-C のクラスの名前と一致する必要があります。 `<param name>`私はする必要があります常に `"ios-package"` 。 このセットアップに従っていない場合、プラグイン コンパイル可能性がありますが、コルドバ到達されませんされます。
@@ -40,7 +42,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
それぞれの人生のためのプラグイン オブジェクトの 1 つのインスタンスが作成されます `UIWebView` 。 プラグインはまでインスタンス化されない最初、JavaScript から呼び出しによって参照されている場合を除き `<param>` と、 `onload` `name` 属性を設定する `"true"` で `config.xml` 。 例えば。
- < 機能名 =「エコー」>< param の名前「ios パッケージ」値を = =「エコー」/>< param の名前"onload"値を = ="true"/></機能 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
*ない*プラグインの初期化子を指定します。代わりに、プラグインを使用する必要があります、 `pluginInitialize` 、スタート アップ ロジックのメソッド。
@@ -53,7 +58,18 @@ Java スクリプトの設定をネイティブ側に要求するプラグイン
どのような JavaScript の経由でプラグインにディスパッチを取得 `exec` 関数で渡される対応するプラグイン クラスの `action` メソッド。プラグインのメソッドは、この署名。
- -(void) myMethod:(CDVInvokedUrlCommand*) コマンド {CDVPluginResult * pluginResult = nil;NSString * myarg = [command.arguments objectAtIndex:0];場合 （myarg! = nil) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];} 他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg が null"];} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];}
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
1. [CDVInvokedUrlCommand.h][1]
@@ -70,7 +86,7 @@ Java スクリプトの設定をネイティブ側に要求するプラグイン
CDVPluginResult を使用してを返すことができますさまざまな結果型を JavaScript コールバックに戻るのようなクラスのメソッドを使用しています。
- + (CDVPluginResult *) resultWithStatus: (CDVCommandStatus) statusOrdinal messageAs.
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
作成することができます `String` 、 `Int` 、 `Double` 、 `Bool` 、 `Array` 、 `Dictionary` 、 `ArrayBuffer` 、および `Multipart` の種類。 または、任意の引数 (ちょうど送信ステータス) を添付しないでください。 または、エラーを返します。 その場合、コールバックは発生しませんないすべてで任意のプラグインの結果を送信することもできます。
@@ -85,12 +101,45 @@ CDVPluginResult を使用してを返すことができますさまざまな結
我々 は、次のプロジェクトに追加の `config.xml` ファイル。
- < 機能名 =「エコー」>< param の名前 = 値「ios パッケージ」=「エコー」/></機能 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
我々 は、次のファイルを追加し、( `Echo.h` および `Echo.m` ) 私たちコルドバ iOS アプリケーション フォルダー内にプラグインのフォルダーに：
- /--- Echo.h コルドバ プラグイン ヘッダー ---/#import < Cordova/CDV.h > @interface エコー： CDVPlugin - (void) エコー:(CDVInvokedUrlCommand*) コマンド;@end/--- Echo.m コルドバのプラグイン実装 * * */#import"Echo.h"#import < Cordova/CDV.h > @implementation エコー - (void) エコー:(CDVInvokedUrlCommand*) コマンド {CDVPluginResult * pluginResult = nil;NSString * エコー = [command.arguments objectAtIndex:0];場合 (エコー ！ = nil & & [エコー長さ] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];} 他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];} @end
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDV.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
コードを見てをみましょう。上部に我々 はすべての必要なコルドバ輸入があります。私たちのクラスから拡張 `CDVPlugin` (非常に重要）。
@@ -105,10 +154,17 @@ CDVPluginResult を使用してを返すことができますさまざまな結
プラグインのメソッドは、UI と同じスレッドで実行されます。あなたのプラグイン大量の処理が必要です、ブロッキング呼び出しを必要とする場合は、バック グラウンド スレッドを使用してください。たとえば。
- -(void) myPluginMethod:(CDVInvokedUrlCommand*) コマンド {//command.arguments をここでチェックします。
- [self.commandDelegate runInBackground: ^ {NSString * ペイロード = nil;//いくつかのロジックをブロック.
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];//SendPluginResult メソッドはスレッド セーフです。
- [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];}];}
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }];
+ }
## 高度なプラグイン機能
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/ko/edge/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/docs/ko/edge/guide/platforms/android/plugin.md b/docs/ko/edge/guide/platforms/android/plugin.md
index 322f013..be5df68 100644
--- a/docs/ko/edge/guide/platforms/android/plugin.md
+++ b/docs/ko/edge/guide/platforms/android/plugin.md
@@ -24,7 +24,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
플러그인의 자바 부분 항상 사용 하는 `cordova.exec` 메서드가 다음과 같이:
- exec (< successFunction >, < failFunction >, < 서비스 >, < 작업 > [< args >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
이 요청 전화 내려 더 많거나 적은 끓는 안 드 로이드 네이티브 쪽을 WebView에서 마샬링하는 `action` 메서드는 `service` 클래스에 전달 된 인수는 `args` 배열.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/ko/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/ko/edge/guide/platforms/ios/plugin.md b/docs/ko/edge/guide/platforms/ios/plugin.md
index 1c15f7d..0d55d72 100644
--- a/docs/ko/edge/guide/platforms/ios/plugin.md
+++ b/docs/ko/edge/guide/platforms/ios/plugin.md
@@ -24,14 +24,16 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
플러그인의 자바 부분 항상 사용 하는 `cordova.exec` 메서드가 다음과 같이:
- exec (< successFunction >, < failFunction >, < 서비스 >, < 작업 > [< args >]);
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
이 요청을 마샬링하는 `UIWebView` iOS 기본 측면, 더 많거나 적은 전화 아래로 끓는 `action` 메서드는 `service` 인수에 전달 된 클래스는 `args` 배열.
지정한 플러그인으로는 `<feature>` 코르도바 iOS 응용 프로그램의 프로젝트에 태그 `config.xml` 파일.
- < 기능 이름 "LocalStorage" = >< param 이름을 = "ios 패키지" 값 = "CDVLocalStorage" / >< / 기능 >
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
기능 `name` 특성은 자바 스크립트의 사용 일치 해야 `exec` 호출의 `service` 매개 변수, 및 `value` 특성 플러그인의 목표-C 클래스의 이름과 일치 해야 합니다. `<param name>`난 항상 이어야 한다 `"ios-package"` . 이 설치를 수행 하지 않으면, 플러그인 컴파일 수 있습니다 하지만 코르도바 연결할 수 수 없습니다.
@@ -40,7 +42,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
각각의 인생에 대 한 플러그인 개체의 인스턴스 생성 `UIWebView` . 플러그인은 인스턴스화되지 않습니다 JavaScript에서 호출 하 여 처음 참조 될 때까지 않는 한 `<param>` 와 `onload` `name` 특성 설정 `"true"` 에 `config.xml` . 예를 들면:
- < 기능 이름 "에코" = >< param 이름을 "ios 패키지" 값 = "에코" = / >< param 이름을 = "onload" 값 = "true" / >< / 기능 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
*아니* 플러그인에 대 한 이니셜라이저를 지정입니다. 대신, 플러그인을 사용 해야 합니다에 `pluginInitialize` 그들의 시작 논리에 대 한 방법.
@@ -53,12 +58,17 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
무슨 자바 스크립트를 통해 플러그인에 파견 되 면 `exec` 함수는 해당 플러그인 클래스에 전달 되 면 `action` 메서드. 플러그인 방법이이 서명을 했다:
- -(void) myMethod:(CDVInvokedUrlCommand*) 명령 {CDVPluginResult * pluginResult = 없음;
- NSString * myarg = [command.arguments objectAtIndex:0];
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
- 경우 (myarg! = nil) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
- } 다른 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg null 했다"];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}
@@ -76,7 +86,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
CDVPluginResult를 사용 하 여 돌아갈 수 있습니다 다양 한 결과 형식 다시 자바 스크립트 콜백을 처럼 클래스 메서드를 사용 하 여:
- + (CDVPluginResult *) resultWithStatus: (CDVCommandStatus) statusOrdinal messageAs...
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
만들 수 있는 `String` , `Int` , `Double` , `Bool` , `Array` , `Dictionary` , `ArrayBuffer` , 및 `Multipart` 형식. 또는 인수 (그냥 송신 상태)를 첨부 하지 않습니다. 또는 오류를 반환 합니다. 선택할 수 있습니다 심지어 어떤 플러그인 결과 전혀 보내지를 어떤 경우에 콜백이 발생 하지 않습니다.
@@ -91,20 +101,45 @@ CDVPluginResult를 사용 하 여 돌아갈 수 있습니다 다양 한 결과
우리는 프로젝트의 다음에 추가할 `config.xml` 파일:
- < 기능 이름 "에코" = >< param 이름을 "ios 패키지" 값 = "에코" = / >< / 기능 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
그 후에 다음 파일 추가 ( `Echo.h` 및 `Echo.m` ) 우리의 코르도바 iOS 응용 프로그램 폴더 안의 플러그인 폴더에:
- / --- Echo.h 코르도바 플러그인 헤더 --- / #import < Cordova/CDV.h > @interface 에코: CDVPlugin-(void) 에코:(CDVInvokedUrlCommand*) 명령;
+ /********* Echo.h Cordova Plugin Header *******/
- @end / --- Echo.m 코르도바 플러그인 구현 --- / #import "Echo.h" #import < Cordova/CDV.h > @implementation 에코-(void) 에코:(CDVInvokedUrlCommand*) 명령 {CDVPluginResult * pluginResult = 없음;
- NSString * 에코 = [command.arguments objectAtIndex:0];
+ #import <Cordova/CDV.h>
- 경우 (에코! = 대 0 & & [에코 길이] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
- } 다른 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
- } [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
- } @end
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
코드를 살펴 봅시다. 상단에 우리는 모든 필요한 코르 도우 바 수입. 우리의 클래스에서 확장 `CDVPlugin` (매우 중요).
@@ -119,11 +154,14 @@ CDVPluginResult를 사용 하 여 돌아갈 수 있습니다 다양 한 결과
플러그인 메서드는 UI와 동일한 스레드에서 실행 됩니다. 귀하의 플러그인 처리의 큰 거래를 필요로 하거나 차단 호출, 백그라운드 스레드를 사용 해야 합니다. 예를 들어:
- -(void) myPluginMethod:(CDVInvokedUrlCommand*) 명령 {/ / 여기 command.arguments를 확인 합니다.
- [self.commandDelegate runInBackground: ^ {NSString * 페이로드 = 없음;
- / / 일부 논리를 차단...
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
- / / SendPluginResult 메서드는 스레드로부터 안전 합니다.
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
[self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
}];
}
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/zh/edge/guide/platforms/android/plugin.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/android/plugin.md b/docs/zh/edge/guide/platforms/android/plugin.md
index 6aea925..ef4973b 100644
--- a/docs/zh/edge/guide/platforms/android/plugin.md
+++ b/docs/zh/edge/guide/platforms/android/plugin.md
@@ -24,7 +24,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
一個外掛程式的 JavaScript 部分始終使用 `cordova.exec` 方法，如下所示：
- exec （< successFunction > < failFunction >、 < 服務 >、 < 行動 > [< args >]) ；
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
這封送從 web 視圖到 Android 的本機方面，更多或更少沸騰到調用請求 `action` 上的方法 `service` 類，傳入的參數中的 `args` 陣列。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/ba7793a5/docs/zh/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/guide/platforms/ios/plugin.md b/docs/zh/edge/guide/platforms/ios/plugin.md
index 1011db7..f4c4257 100644
--- a/docs/zh/edge/guide/platforms/ios/plugin.md
+++ b/docs/zh/edge/guide/platforms/ios/plugin.md
@@ -24,14 +24,16 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
一個外掛程式的 JavaScript 部分始終使用 `cordova.exec` 方法，如下所示：
- exec （< successFunction > < failFunction >、 < 服務 >、 < 行動 > [< args >]) ；
+ exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
這封送一個請求從 `UIWebView` 到 iOS 本機側，更或較不沸騰到調用 `action` 方法 `service` 類，傳入的參數中的 `args` 陣列。
指定外掛程式作為 `<feature>` 在科爾多瓦 iOS 應用程式專案中的標記 `config.xml` 檔。
- < 功能名稱 ="認為">< 參數名稱 ="ios 包"值 ="CDVLocalStorage"/ >< / 功能 >
+ <feature name="LocalStorage">
+ <param name="ios-package" value="CDVLocalStorage" />
+ </feature>
功能 `name` 屬性應匹配您在 JavaScript 中使用 `exec` 調用的 `service` 參數，和 `value` 屬性應與外掛程式的目標 C 類的名稱相匹配。 `<param name>`應始終是我 `"ios-package"` 。 如果不遵循此安裝程式，該外掛程式可能編譯，但不是會到達科爾多瓦。
@@ -40,7 +42,10 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
外掛程式物件的一個實例創建為生活的每個 `UIWebView` 。 外掛程式不會具現化之前他們第一次引用通過調用從 JavaScript，除非 `<param>` 與 `onload` `name` 屬性設置為 `"true"` 的 `config.xml` 。 例如：
- < 功能名稱 ="回聲">< 參數名稱 ="ios 包"值 ="回聲"/ >< 參數名稱 ="onload"值 ="true"/ >< / 功能 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ <param name="onload" value="true" />
+ </feature>
有*沒有*指定外掛程式的初始值設定項。相反，應使用外掛程式 `pluginInitialize` 他們開辦的邏輯方法。
@@ -53,7 +58,18 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
什麼獲取調度到該外掛程式通過 JavaScript 的 `exec` 函數獲取傳遞到相應的外掛程式類的 `action` 方法。外掛程式的方法有此簽名：
- -（失效） myMethod:(CDVInvokedUrlCommand*) 命令 {CDVPluginResult * pluginResult = 零 ；NSString * myarg = [command.arguments objectAtIndex:0];如果 (myarg! = 無) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];} 其他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg 為空"] ；} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；}
+ - (void)myMethod:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* myarg = [command.arguments objectAtIndex:0];
+
+ if (myarg != nil) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+ }
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
1. [CDVInvokedUrlCommand.h][1]
@@ -70,7 +86,7 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
使用 CDVPluginResult 可以返回結果類型的各種回您的 JavaScript 回呼函數，使用看起來像的類方法：
- + (CDVPluginResult *) resultWithStatus： (CDVCommandStatus) statusOrdinal messageAs......
+ + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
您可以創建 `String` ， `Int` ， `Double` ， `Bool` ， `Array` ， `Dictionary` ， `ArrayBuffer` ，和 `Multipart` 類型。 或者，不附加任何參數 (只是發送狀態)。 或者，返回一個錯誤。 你甚至可以選擇不發送任何外掛程式的結果，在這種情況下不會觸發回檔。
@@ -85,12 +101,45 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
我們會將以下內容添加到該專案的 `config.xml` 檔：
- < 功能名稱 ="回聲">< 參數名稱 ="ios 包"值 ="回聲"/ >< / 功能 >
+ <feature name="Echo">
+ <param name="ios-package" value="Echo" />
+ </feature>
然後我們將添加下列檔 （ `Echo.h` 和 `Echo.m` ） 的外掛程式資料夾裡面我們科爾多瓦 iOS 應用程式資料夾中：
- / --- Echo.h 科爾多瓦外掛程式頭 --- / #import < Cordova/CDV.h > @interface 回聲： CDVPlugin-(void) echo:(CDVInvokedUrlCommand*) 命令 ；@end / --- Echo.m 科爾多瓦外掛程式執行 * * * / #import"Echo.h"#import < Cordova/CDV.h > @implementation 回聲-（失效） echo:(CDVInvokedUrlCommand*) 命令 {CDVPluginResult * pluginResult = 零 ；NSString * 回聲 = [command.arguments objectAtIndex:0];如果 (回聲! = 無 & & [回聲長度] > 0) {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];} 其他 {pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];} [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；} @end
+ /********* Echo.h Cordova Plugin Header *******/
+
+ #import <Cordova/CDV.h>
+
+ @interface Echo : CDVPlugin
+
+ - (void)echo:(CDVInvokedUrlCommand*)command;
+
+ @end
+
+ /********* Echo.m Cordova Plugin Implementation *******/
+
+ #import "Echo.h"
+ #import <Cordova/CDV.h>
+
+ @implementation Echo
+
+ - (void)echo:(CDVInvokedUrlCommand*)command
+ {
+ CDVPluginResult* pluginResult = nil;
+ NSString* echo = [command.arguments objectAtIndex:0];
+
+ if (echo != nil && [echo length] > 0) {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo];
+ } else {
+ pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR];
+ }
+
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }
+
+ @end
讓我們看看代碼。在頂部，我們有所有必要的科爾多瓦進口。我們班延伸從 `CDVPlugin` （非常重要）。
@@ -105,10 +154,17 @@ license: Licensed to the Apache Software Foundation (ASF) under one or more cont
在相同的 UI 執行緒中執行的外掛程式方法。如果你的外掛程式需要大量的處理，或者需要一個阻塞調用，則應使用後臺執行緒。例如：
- -（失效） myPluginMethod:(CDVInvokedUrlCommand*) 命令 {/ / 檢查 command.arguments 在這裡。
- [self.commandDelegate runInBackground: ^ {NSString * 有效載荷 = 零 ；/ 有些阻塞的邏輯......
- CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];/ / SendPluginResult 方法是執行緒安全的。
- [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId] ；}];}
+ - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
+ {
+ // Check command.arguments here.
+ [self.commandDelegate runInBackground:^{
+ NSString* payload = nil;
+ // Some blocking logic...
+ CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload];
+ // The sendPluginResult method is thread-safe.
+ [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+ }];
+ }
## 高級的外掛程式功能