You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ag...@apache.org on 2013/10/02 21:59:11 UTC
[04/51] [partial] CB-4975 Add 3.1.0 version of non-english docs.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/android/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/android/upgrading.md b/docs/it/3.1.0/guide/platforms/android/upgrading.md
new file mode 100644
index 0000000..5829317
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/android/upgrading.md
@@ -0,0 +1,411 @@
+---
+
+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.
+---
+
+# L'aggiornamento di Android
+
+Questa guida Mostra come modificare progetti Android per l'aggiornamento da versioni precedenti di Cordova. La maggior parte di queste istruzioni si applicano ai progetti creati con un vecchio set di strumenti da riga di comando che precedono la `cordova` utilità CLI. L'interfaccia della riga di comando per informazioni, vedere come aggiornare la versione di CLI.
+
+## L'aggiornamento a 3.1.0 da 3.0.0
+
+Per i progetti creati con il cordova CLI:
+
+1. Aggiornamento del `cordova` versione CLI - vedere l'interfaccia della riga di comando
+2. Eseguire`cordova platform update android`
+
+Per i progetti non creati con la CLI di cordova, eseguire:
+
+1. `bin/aggiornamento < project_path >`
+
+## Aggiornamento per il CLI (3.0.0) da 2.9.0
+
+1. Creare un nuovo progetto di Apache Cordova 3.0.0 utilizzando la CLI, cordova, come descritto in l'interfaccia della riga di comando.
+
+2. Aggiungi il tua piattaforme il progetto il cordova, ad esempio:`cordova
+platform add android`.
+
+3. Copiare il contenuto del tuo progetto `www` nella directory del `www` cartella alla radice del progetto cordova appena creato.
+
+4. Copiare qualsiasi attività nativo dal tuo vecchio progetto nella directory appropriate sotto `platforms/android` : è la directory dove esiste il tuo progetto di cordova-android nativo.
+
+5. Utilizzare lo strumento CLI di cordova per installare il plug-in che è necessario. Si noti che il CLI gestisce tutti i core API come plugin, così che può essere necessario aggiungere. Solo 3.0.0 plugin sono compatibili con il CLI.
+
+## Aggiornamento a 3.0.0 da 2.9.0
+
+1. Creare un nuovo progetto Apache Cordova Android.
+
+2. Copiare il contenuto del tuo `www` nella directory del nuovo progetto.
+
+3. Copiare qualsiasi attività nativo Android dal tuo `res` nella directory del nuovo progetto.
+
+4. Copia su qualsiasi plugin installato dalla `src` sottodirectory nel nuovo progetto.
+
+5. Assicurarsi di aggiornare qualsiasi deprecato `<plugin>` riferimenti dal vecchio `config.xml` file per il nuovo `<feature>` specifica.
+
+6. Aggiornare tutti i riferimenti per il `org.apache.cordova.api` pacchetto di`org.apache.cordova`.
+
+* **Nota:** tutti i core API sono stati rimossi e devono essere installate come plugin. Per dettagli, vedere la Plugman usando per gestire guida Plugins.
+
+## Aggiornamento a 2.9.0 da 2.8.0
+
+1. Eseguire`bin/update <project_path>`.
+
+## Aggiornamento a 2.8.0 da 2.7.0
+
+1. Rimuovere `cordova-2.7.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.8.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova.js` file.
+
+6. Copia il `res/xml/config.xml` file per abbinare`framework/res/xml/config.xml`.
+
+7. Aggiornamento `framework/res/xml/config.xml` per avere impostazioni simili, come ha fatto in precedenza.
+
+8. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.7.0 da 2.6.0
+
+1. Rimuovere `cordova-2.6.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.7.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.7.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.7.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Aggiornamento `framework/res/xml/config.xml` per avere impostazioni simili, come ha fatto in precedenza.
+
+8. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.6.0 da 2.5.0
+
+1. Rimuovere `cordova-2.5.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.6.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.6.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.6.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Aggiornamento `framework/res/xml/config.xml` per avere impostazioni simili, come ha fatto in precedenza.
+
+8. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+Eseguire `bin/update <project>` con il percorso del progetto elencati nella directory dei sorgenti di Cordova.
+
+## Aggiornamento a 2.5.0 da 2.4.0
+
+1. Rimuovere `cordova-2.4.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.5.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.5.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.5.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Aggiornamento `framework/res/xml/config.xml` per avere impostazioni simili, come ha fatto in precedenza.
+
+8. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.4.0 da 2.3.0
+
+1. Rimuovere `cordova-2.3.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.4.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.4.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.4.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.3.0 da 2.2.0
+
+1. Rimuovere `cordova-2.2.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.3.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.3.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.3.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.2.0 da 2.1.0
+
+1. Rimuovere `cordova-2.1.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.2.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.2.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.2.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.1.0 da 2.0.0
+
+1. Rimuovere `cordova-2.0.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.1.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.1.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.1.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+7. Copiare i file da `bin/templates/cordova` per il progetto `cordova` directory.
+
+## Aggiornamento a 2.0.0 da 1.9.0
+
+1. Rimuovere `cordova-1.9.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-2.0.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-2.0.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.0.0.js` file.
+
+6. Copia il `res/xml/config.xml` corrispondere`framework/res/xml/config.xml`.
+
+### Note sui 2.0.0 rilasciare
+
+`config.xml`sarà essere sostituendo `cordova.xml` e `plugins.xml` . Questo nuovo file è una combinazione delle due precedenti. Tuttavia, i vecchi file sono obsolete e mentre funzionano attualmente ancora, cesserà lavorando in una versione futura.
+
+## Aggiornamento a 1.9.0 da 1.8.1
+
+1. Rimuovere `cordova-1.8.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.9.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.9.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.9.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+### Note sui 1.9.0 rilasciare
+
+A causa dell'introduzione della `CordovaWebView` , plugin di terze parti potrebbero non funzionare. Questi plugin necessario per ottenere un contesto dalla `CordovaInterface` utilizzando `getContext()` o `getActivity()` . Se non sei un esperto sviluppatore Android, si prega di contattare il manutentore di plugin e aggiungere questo compito a loro tracciatore di bug.
+
+## Aggiornamento a 1.8.0 da 1.8.0
+
+1. Rimuovere `cordova-1.8.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.8.1.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.8.1.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.8.1.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.8.0 da 1.7.0
+
+1. Rimuovere `cordova-1.7.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.8.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.8.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.8.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.8.0 da 1.7.0
+
+1. Rimuovere `cordova-1.7.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.8.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.8.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.8.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.7.0 da 1.6.1
+
+1. Rimuovere `cordova-1.6.1.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.7.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.7.0.js` nel vostro progetto.
+
+5. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.6.1 da 1.6.0
+
+1. Rimuovere `cordova-1.6.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.6.1.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.6.1.js` nel vostro progetto.
+
+5. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.6.0 da 1.5.0
+
+1. Rimuovere `cordova-1.5.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.6.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.6.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.6.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+7. Sostituire `res/xml/phonegap.xml` con `res/xml/cordova.xml` da abbinare`framework/res/xml/cordova.xml`.
+
+## Aggiornamento a 1.5.0 da 1.4.0
+
+1. Rimuovere `phonegap-1.4.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `cordova-1.5.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `cordova-1.5.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.5.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+7. Sostituire `res/xml/phonegap.xml` con `res/xml/cordova.xml` da abbinare`framework/res/xml/cordova.xml`.
+
+## Aggiornamento a 1.4.0 da 1.3.0
+
+1. Rimuovere `phonegap-1.3.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `phonegap-1.4.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `phonegap-1.4.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `phonegap-1.4.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+7. Aggiornamento `res/xml/phonegap.xml` per abbinare`framework/res/xml/phonegap.xml`.
+
+## Aggiornamento a 1.3.0 da 1.2.0
+
+1. Rimuovere `phonegap-1.2.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `phonegap-1.3.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `phonegap-1.3.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `phonegap-1.2.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+7. Aggiornamento `res/xml/phonegap.xml` per abbinare`framework/res/xml/phonegap.xml`.
+
+## Aggiornamento a 1.2.0 da 1.1.0
+
+1. Rimuovere `phonegap-1.1.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `phonegap-1.2.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `phonegap-1.2.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `phonegap-1.2.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+7. Aggiornamento `res/xml/phonegap.xml` per abbinare`framework/res/xml/phonegap.xml`.
+
+## Aggiornamento a 1.1.0 da 1.0.0
+
+1. Rimuovere `phonegap-1.0.0.jar` del progetto `libs` directory.
+
+2. Aggiungi `phonegap-1.1.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `phonegap-1.1.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `phonegap-1.1.0.js` file.
+
+6. Aggiornamento `res/xml/plugins.xml` per abbinare`framework/res/xml/plugins.xml`.
+
+## Aggiornamento a 1.0.0 da 0.9.6
+
+1. Rimuovere `phonegap-0.9.6.jar` del progetto `libs` directory.
+
+2. Aggiungi `phonegap-1.0.0.jar` al progetto `libs` directory.
+
+3. Se si utilizza Eclipse, si prega di aggiornare il vostro progetto di eclipse e fare una pulita.
+
+4. Copiare il nuovo `phonegap-1.0.0.js` nel vostro progetto.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `phonegap-1.0.0.js` file.
+
+6. Aggiungere il `res/xml/plugins.xml` corrispondere`framework/res/xml/plugins.xml`.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/android/webview.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/android/webview.md b/docs/it/3.1.0/guide/platforms/android/webview.md
new file mode 100644
index 0000000..6a83a2a
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/android/webview.md
@@ -0,0 +1,114 @@
+---
+
+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.
+---
+
+# Visualizzazioni Web Android
+
+Partire da 1,9 a Cordova, con l'assistenza della `CordovaActivity` , è possibile utilizzare Cordova come componente di un'applicazione Android nativa più grande. Android si riferisce a questo componente come il `CordovaWebView` . Nuove applicazioni basate su Cordova da 1,9 in poi utilizzano il `CordovaWebView` come visualizzazione principale, indipendentemente dal fatto che l'eredità `CordovaActivity` approccio viene utilizzato.
+
+Se si ha familiarità con lo sviluppo di applicazioni Android, Android piattaforma guida allo sviluppo di un'applicazione di Cordova prima di tentare di comprendere un WebView. Non è il modo principale per creare applicazioni Android Cordova. Queste istruzioni sono attualmente manuale, ma può essere eventualmente essere automatizzato.
+
+## Prerequisiti
+
+* Cordova 1,9 o maggiore
+
+* Android SDK aggiornato all'ultimo SDK
+
+## Guida all'utilizzo di CordovaWebView in un progetto Android
+
+1. `cd`in `/framework` ed eseguire `ant jar` per costruire il barattolo di cordova. Crea il file. jar formato come `cordova-x.x.x.jar` nel `/framework` directory.
+
+2. Copiare il barattolo di cordova nel vostro progetto Android `/libs` directory.
+
+3. Modifica dell'applicazione `main.xml` file (sotto `/res/xml` ) per essere simile alla seguente, con la `layout_height` , `layout_width` e `id` modificato per soddisfare la vostra applicazione:
+
+ <org.apache.cordova.CordovaWebView
+ android:id="@+id/tutorialView"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent" />
+
+
+4. Modificare la vostra attività che implementa il `CordovaInterface` . È necessario implementare i metodi inclusi. Si potrebbe desiderare di copiarli da `/framework/src/org/apache/cordova/CordovaActivity.java` , o implementarle sul proprio. Il frammento di codice riportato di seguito viene illustrata un'applicazione di base che utilizza l'interfaccia. Si noti come l'id di riferimento vista corrisponde la `id` attributo specificato nel frammento XML sopra indicato:
+
+ public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+ CordovaWebView cwv;
+ /* Called when the activity is first created. */
+ @Override
+ public void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.main);
+ cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+ Config.init(this);
+ cwv.loadUrl(Config.getStartUrl());
+ }
+
+
+Se si utilizza la fotocamera, è necessario implementare anche questo:
+
+ @Override
+ public void setActivityResultCallback(CordovaPlugin plugin) {
+ this.activityResultCallback = plugin;
+ }
+ /**
+ * Launch an activity for which you would like a result when it finished. When this activity exits,
+ * your onActivityResult() method is called.
+ *
+ * @param command The command object
+ * @param intent The intent to start
+ * @param requestCode The request code that is passed to callback to identify the activity
+ */
+ public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+ this.activityResultCallback = command;
+ this.activityResultKeepRunning = this.keepRunning;
+
+ // If multitasking turned on, then disable it for activities that return results
+ if (command != null) {
+ this.keepRunning = false;
+ }
+
+ // Start activity
+ super.startActivityForResult(intent, requestCode);
+ }
+
+ @Override
+ /**
+ * Called when an activity you launched exits, giving you the requestCode you started it with,
+ * the resultCode it returned, and any additional data from it.
+ *
+ * @param requestCode The request code originally supplied to startActivityForResult(),
+ * allowing you to identify who this result came from.
+ * @param resultCode The integer result code returned by the child activity through its setResult().
+ * @param data An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+ */
+ protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+ super.onActivityResult(requestCode, resultCode, intent);
+ CordovaPlugin callback = this.activityResultCallback;
+ if (callback != null) {
+ callback.onActivityResult(requestCode, resultCode, intent);
+ }
+ }
+
+
+Infine, ricordarsi di aggiungere il pool di thread, altrimenti il plugin non hanno nessun thread per eseguire:
+
+ @Override
+ public ExecutorService getThreadPool() {
+ return threadPool;
+ }
+
+
+1. Copiare i file dell'applicazione HTML e JavaScript del progetto Android `/assets/www` directory.
+
+2. Copia `config.xml` dal `/framework/res/xml` al tuo progetto `/res/xml` directory.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry/config.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry/config.md b/docs/it/3.1.0/guide/platforms/blackberry/config.md
new file mode 100644
index 0000000..440dc75
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry/config.md
@@ -0,0 +1,22 @@
+---
+
+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.
+---
+
+# Configurazione di blackBerry
+
+BlackBerry supporta pienamente il [W3C Widget specifica][1] così come le estensioni proprietarie di RIM. Si prega di consultare il completo [per quanto riguarda la documentazione di BlackBerry WebWorks config. xml][2] per i dettagli.
+
+ [1]: http://www.w3.org/TR/widgets/
+ [2]: https://developer.blackberry.com/html5/documentation/working_with_config_xml_file_1866970_11.html
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry/index.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry/index.md b/docs/it/3.1.0/guide/platforms/blackberry/index.md
new file mode 100644
index 0000000..8524b1e
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry/index.md
@@ -0,0 +1,158 @@
+---
+
+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.
+---
+
+# Guida piattaforma blackBerry
+
+Questa guida viene illustrato come configurare un ambiente SDK per le applicazioni di destinazione per la piattaforma BlackBerry precedenti alla versione 10. Se volete la versione più recente di destinazione, vedere la guida di piattaforma BlackBerry 10. Vedere la seguente per informazioni più dettagliate specifiche della piattaforma:
+
+* Configurazione di blackBerry
+* L'aggiornamento di BlackBerry
+* BlackBerry Plugins
+* Strumenti della riga di comando di blackBerry
+
+Gli strumenti della riga di comando qui sopra si riferiscono a versioni precedenti alla 3.0 di Cordova. Per informazioni sull'interfaccia corrente, vedere l'interfaccia della riga di comando.
+
+## Requisiti e supporto
+
+Questa versione di BlackBerry non è supportata dalla `cordova` utilità descritto in l'interfaccia della riga di comando, ma da un insieme distinto di strumenti da riga di comando. Scaricare la distribuzione di Cordova da [cordova.apache.org][1].
+
+ [1]: http://cordova.apache.org/#download
+
+Cordova per BlackBerry si basa sul [quadro BlackBerry WebWorks][2], che è disponibile per Windows XP (32-bit), Windows 7 (32-bit e 64-bit) e Mac (OS X 10.6.4+). WebWorks applicazioni può *solo* essere distribuiti sulle seguenti piattaforme BlackBerry:
+
+ [2]: https://bdsc.webapps.blackberry.com/html5
+
+* BlackBerry OS 5.0 e superiori
+* BlackBerry PlayBook
+* BlackBerry 10 (QNX)
+
+WebWorks richiede il Java Development Kit (JDK). Per Windows, utilizzare la versione a 32 bit del [JDK Oracle][3]. In Java è installato di default su Mac OS X fino alla versione 10.7, che richiede [un'installazione separata][4]. Si richiede inoltre di Apache Ant, che su Mac fa parte dell'installazione Java. La versione di Windows è disponibile da [ant.apache.org][5].
+
+ [3]: http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk
+ [4]: http://support.apple.com/kb/DL1421
+ [5]: http://ant.apache.org/bindownload.cgi
+
+## Installare il SDK
+
+Scaricare e installare l'appropriato WebWorks SDK per lo sviluppo. BlackBerry PlayBook e BlackBerry Smartphone WebWorks SDK può essere scaricato dai seguenti percorsi.
+
+* \[BlackBerry PlayBook SDK\] (https://developer.blackberry.com/html5/download/#playbook) e [Adobe Air SDK][6]
+
+* \[BlackBerry smartphone SDK\] (https://developer.blackberry.com/html5/download/#smartphones)
+
+ [6]: http://www.adobe.com/devnet/air/air-sdk-download.html
+
+## Registrati per chiavi di firma
+
+Se si desidera pubblicare l'applicazione su BlackBerry App World, o su un dispositivo reale, è necessario registrarsi per un set di chiavi di firma codice libero. Per farlo, compila il [Modulo d'ordine tasti BlackBerry][7]. Dopo aver ricevuto le chiavi di firma, essi richiedono l'installazione. Vedere il [sito web BlackBerry HTML5/WebWorks][8] per informazioni.
+
+ [7]: https://www.blackberry.com/SignedKeys
+ [8]: https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html
+
+## Installare Cordova
+
+Scaricare ed estrarre l'ultima copia di [Cordova][1].
+
+## Impostare un nuovo progetto
+
+* Aprire un terminale da riga di comando e spostarsi dove avete estratto di Cordova.
+
+* C'è una directory per ogni piattaforma che supporta di Cordova. Passare al `blackberry` directory.
+
+* Il `blackberry` directory contiene diverse sottodirectory. Il `example` directory contiene un progetto completo di Cordova. Copia il `example` directory in un'altra posizione sul computer e navigare lì.
+
+* Modificare il `project.properties` file per specificare WebWorks SDK si utilizza. Ad esempio, qui sono le rispettive impostazioni per BlackBerry PlayBook, Smartphone BlackBerry (OS5-7) o BlackBerry 10 (QNX):
+
+ playbook.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks SDK per il Tablet 2.1.0.6\\bbwp blackberry.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks Packager qnx.bbwp.dir=C:\\Program Files (x86) \\Research In Motion\\BlackBerry 10 WebWorks SDK 1.0.2.9
+
+
+Questi corrispondono ai parametri specificati quando si compila il progetto. La prima volta che si eseguono questi comandi, che generano un'applicazione "HelloWorld":
+
+ Cordova/compilazione playbook cordova/compilazione blackberry cordova/compilazione qnx
+
+
+Insieme al SDK, è inoltre necessario registrare una chiave di firma codice e token di debug. La chiave di firma consente di distribuire applicazioni attraverso il mondo BlackBerry. Il token di debug consente di testare le applicazioni unsigned su un emulatore di BlackBerry o un dispositivo. Non è necessario creare e installare il token di debug da soli; Se la password del keystore, lo script di compilazione crea e installa il token di debug per voi. Per impostare la chiave di firma, visitare il sito Web di BlackBerry per ottenerlo, facendo attenzione a conservare la password specificata. Quindi eseguire il `blackberry-signer` utilità che è incluso con il SDK. BlackBerry fornisce ulteriori informazioni qui:
+
+* [Registrati per il chiave di firma del codice][9]
+
+* [Configurare il computer per la firma del codice][10]
+
+* [guida completa alla creazione di ambiente SDK][11]
+
+ [9]: https://www.blackberry.com/SignedKeys/codesigning.html
+ [10]: http://developer.blackberry.com/html5/documentation/set_up_for_signing.html
+ [11]: http://developer.blackberry.com/native/documentation/bb10/com.qnx.doc.native_sdk.quickstart/topic/set_up_your_environment.html
+
+## Distribuire all'emulatore
+
+Emulatori di smartphone blackBerry sono disponibili solo su Windows. Emulatori di blackBerry PlayBook richiedono VMWare Player (Windows) o VMWare Fusion (Mac OS X). WebWorks SDK fornisce un emulatore di default, ma altri emulatori sono [disponibili tramite BlackBerry][12].
+
+ [12]: http://us.blackberry.com/developers/resources/simulators.jsp
+
+Dalla directory del progetto, digitare `./cordova/run <target>` , sostituendo `<target>` con uno `qnx` , `playbook` , o `blackberry` . Si noti che per 10 BlackBerry e PlayBook, l'immagine virtuale emulatore deve già avviato.
+
+Vedere le seguenti per ulteriori informazioni:
+
+* [BlackBerry PlayBook][13]
+
+* [Smartphone blackBerry][14]
+
+ [13]: https://developer.blackberry.com/html5/documentation/using_the_tablet_simulator_1866980_11.html
+ [14]: https://developer.blackberry.com/html5/documentation/run_your_app_on_smartphone_sim_1876976_11.html
+
+Per BlackBerry Playbook, modificare il `project.properties` file per personalizzare il `playbook.sim.ip` e `playbook.sim.password` proprietà. Indirizzo IP dell'emulatore è disponibile attraverso l'applicazione **Impostazioni** sulla schermata home. Abilitare il **sicurezza e Privacy → modalità di sviluppo** opzione per visualizzare l'indirizzo. La password può essere impostata anche nella scheda **sicurezza e Privacy** .
+
+Smartphone BlackBerry, modificare il `project.properties` file per personalizzare il `blackberry.sim.dir` e `blackberry.sim.bin` proprietà. Avete bisogno di fuggire i delimitatori del percorso quando si specificano i percorsi di directory su Windows, ad esempio:`C:\\Program
+Files\\BlackBerry\\Simulator`.
+
+Una volta che l'emulatore è installato e in esecuzione, eseguire uno dei seguenti per installare un'applicazione alla schermata iniziale:
+
+ blackberry cordova esecuzione/Cordova/Esegui playbook
+
+
+Se viene richiesto se un dispositivo è collegato al computer, rispondere no.
+
+**Nota:** Su BlackBerry OS 5, l'applicazione viene installata nella `Downloads` directory.
+
+## Distribuire al dispositivo
+
+Per distribuire l'applicazione a un dispositivo, deve essere collegato, e devi essere registrato per codice chiavi di firma, come descritto sopra. Inoltre, per distribuire le applicazioni su BlackBerry PlayBook, il **Impostazioni → sicurezza → modalità di sviluppo** opzione deve essere attivata.
+
+Sul BlackBerry PlayBook, modificare il `project.properties` del file e modificare il seguente per riflettere il dispositivo IP e password come descritto sopra, insieme con la firma chiave password si imposta:
+
+Dalla directory del progetto, digitare `./cordova/run <target>` , sostituendo `<target>` con uno `qnx` , `playbook` , o`blackberry`.
+
+BlackBerry smartphone (OS5-7), specificare la `blackberry.sigtool.password` proprietà come password firma chiave.
+
+Poi dalla directory del progetto, eseguire uno dei comandi che si farebbe per visualizzare le app in un emulatore:
+
+ blackberry cordova esecuzione/Cordova/Esegui playbook
+
+
+Se viene richiesto se un dispositivo è collegato al computer, rispondete sì.
+
+**Nota:** Su BlackBerry OS 5, l'applicazione viene installata nella `Downloads` directory.
+
+## Informazioni aggiuntive
+
+Gli articoli seguenti possono contribuire a risolvere problemi comuni durante lo sviluppo di applicazioni create per BlackBerry WebWorks framework:
+
+* [BlackBerry WebWorks sviluppo insidie][15]
+
+* [Consigliate per applicazioni WebWorks di imballaggio][16]
+
+ [15]: http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/Common-BlackBerry-WebWorks-development-pitfalls-that-can-be/ta-p/624712
+ [16]: https://bdsc.webapps.blackberrycom/html5/documentation/ww_developing/bestpractice_compiling_ww_apps_1873324_11.html
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry/plugin.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry/plugin.md b/docs/it/3.1.0/guide/platforms/blackberry/plugin.md
new file mode 100644
index 0000000..60d2a38
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry/plugin.md
@@ -0,0 +1,102 @@
+---
+
+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.
+---
+
+# BlackBerry Plugins
+
+Questa guida illustra come sviluppare un plugin Echo sul BlackBerry. La guida allo sviluppo di Plugin fornisce un'ampia panoramica con cui si dovrebbe già avere familiarità, e questa guida riprende da dove lascia fuori. Inoltre, scaricare la [repository di Cordova BlackBerry][1].
+
+ [1]: https://git-wip-us.apache.org/repos/asf?p=cordova-blackberry-webworks.git;a=summary
+
+Il `Cordova-BlackBerry` progetto consente di distribuire ai dispositivi BlackBerry come la torcia, grassetto e Playbook. Il Playbook utilizza un diverso codice base rispetto ad altri dispositivi palmari BlackBerry, per cui è necessario duplicare i vostri sforzi di sviluppo. Questa guida si concentra su dispositivi palmari anziché compresse. (In futuro, questa guida dovrebbe coprire entrambe le piattaforme).
+
+Il plugin Echo restituisce essenzialmente qualunque messaggio un utente fornisce per la `window.echo` funzione:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+## Modifica plugins
+
+Il progetto `www/plugins.xml` directory contiene tutti i riferimenti necessari plugins del vostro progetto di Cordova. Aggiungere un ulteriore riferimento così che quando `cordova.exec` è chiamato, Cordova conosce come mappare il `Echo` argomento di `cordova.exec` per la `Echo` classe che vogliamo scrivere nativamente:
+
+ <feature name="Echo">
+ <param name="blackberry-package" value="org.apache.cordova.echo.Echo" />
+ </feature>
+
+
+## L'aggiunta di Echo.java
+
+Se si nota la struttura dell'attributo value, vedrete un percorso definito che conduce al plugin Echo. Nella directory radice del repo Cordova BlackBerry WebWorks, cercare una directory chiamata `framework` . Questa directory contiene tutto il codice sorgente che gira nativamente su BlackBerry. Passare a `framework/ext/src/org/apache/cordova` . A questo punto, vedrete tutti i plugin directorys, che all'interno della quale è il codice sorgente. Quindi aggiungere l'eco directory per `framework/ext/src/org/apache/cordova/echo` e creare un file chiamato `Echo.java` a`framework/ext/src/org/apache/cordova/echo/Echo.java`.
+
+## Scrittura Echo.java
+
+L'idea base scrivendo un plugin è quello di creare una classe che estende la classe Plugin e un metodo chiamato `execute` per restituire un `PluginResult` classe. Tutte le chiamate a `cordova.exec` passa nell'azione da eseguire all'interno della classe, così come gli argomenti. In questo caso, "eco" è l'azione che vogliamo eseguire all'interno della classe "Echo" e [str] sono gli argomenti che stiamo passando in.
+
+ package org.apache.cordova.echo;
+
+ import org.apache.cordova.api.Plugin;
+ import org.apache.cordova.api.PluginResult;
+ import org.apache.cordova.json4j.JSONArray;
+ import org.apache.cordova.json4j.JSONException;
+ import org.apache.cordova.json4j.JSONObject;
+ /**
+ * A simple plugin to demonstrate how to build a plugin for BlackBerry
+ * Basically echos back the msg that a user calls to this plugin
+ */
+ public final class Echo extends Plugin {
+
+ public static final String echo = "echo";
+
+ public PluginResult execute(String action, JSONArray args, String callbackId) {
+ PluginResult result = new PluginResult(PluginResult.Status.INVALID_ACTION, "Echo: Invalid action:" + action);
+ if(action.equals(echo)){
+ try {
+ String theMsg = args.getString(0);
+ if(theMsg!= null || theMsg.length()>0){
+ result = new PluginResult(PluginResult.Status.OK, theMsg);
+ }else{
+ result = new PluginResult(PluginResult.Status.ERROR, "Nothing to echo.");
+ }
+ } catch (JSONException e) {
+ result = new PluginResult(PluginResult.Status.JSON_EXCEPTION, e.getMessage());
+ }
+ }
+
+ return result;
+ }
+
+ }
+
+
+Così se guardiamo il codice qui sopra, possiamo vedere che all'interno del metodo execute, prima cerchiamo quali azioni stanno arrivando. Il plugin Echo ha solo una azione, `echo` , quindi ci sarà il solo check per quello. Se il nostro plugin aveva più azioni, è semplicemente una questione di aggiungere ulteriori test condizionali per verificare tali azioni.
+
+Abbiamo poi intenzione di afferrare il messaggio proveniente dal argomenti che viene fornito dal parametro args. Noi possiamo afferrare il primo argomento facendo semplicemente`String theMsg = args.getString(0);`.
+
+Faremo qualche errore controllo e se il messaggio sembra OK, ci sarà istanziare un nuovo PluginResult con uno status ok: `PluginResult.Status.OK` e restituire il messaggio: `theMsg` . Dopo questo, abbiamo restituito il risultato che da passare a JavaScript di essere licenziato nel callback di successo. Se qualcosa non riesce, possiamo tornare varie eccezioni di stato come `PluginResult.Status.ERROR` , `PluginResult.Status.JSON_EXCEPTION` , o `PluginResult.Status.INVALID_ACTION` . Quando passato indietro, questi tipi di risultati fuoco il callback di fallire in JavaScript.
+
+## Aggiornando il. jar nella directory www del progetto
+
+L'aggiunto `Echo.java` deve essere aggiornato nel tuo progetto. Per costruire il `.jar` del file, passare alla directory principale di repo BlackBerry WebWorks ed eseguire il `ant` comando:
+
+ ant update -Dproject.path="~/path_to_my_project"
+
+
+Questo crea un nuovo `.jar` del file nella `build/ext` directory. Copia il `build/ext/cordova.jar` del file nel tuo `project/www/ext` directory.
+
+Se tutto va bene, che permette di utilizzare il plugin Echo in BlackBerry.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry/tools.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry/tools.md b/docs/it/3.1.0/guide/platforms/blackberry/tools.md
new file mode 100644
index 0000000..1b3c803
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry/tools.md
@@ -0,0 +1,60 @@
+---
+
+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.
+---
+
+# Strumenti della riga di comando di blackBerry
+
+Il `cordova` l'utilità della riga di comando è uno strumento ad alto livello che consente di creare applicazioni su piattaforme diverse in una volta. Una versione precedente di Cordova framework fornisce il set di strumenti da riga di comando specifici per ogni piattaforma. Per utilizzarli come alternativa alla CLI, dovete scaricare questa versione di Cordova da [cordova.apache.org][1]. Il download contiene archivi separati per ciascuna piattaforma. Espandere la piattaforma che si desidera fare riferimento. Gli strumenti qui descritti sono in genere disponibili nel livello superiore `bin` directory, altrimenti consultare il file **Leggimi** per ulteriori indicazioni.
+
+ [1]: http://cordova.apache.org
+
+## Creare un progetto
+
+Eseguire il `create` comando, specificando il percorso esistente per il progetto, l'identificatore del pacchetto stile retro-dominio e nome visualizzato dell'app. Ecco la sintassi per Mac e Windows:
+
+ $ /path/to/cordova-blackberry-webworks/bin/create /path/to/my_new_project com.example.project_name ProjectName
+ $ /path/to/cordova-blackberry-webworks/bin/create.bat /path/to/my_new_project com.example.project_name ProjectName
+
+
+**Nota:** La piattaforma BlackBerry ignora il segnaposto del nome di pacchetto ( `com.example.project_name` ), ma è ancora necessario per l'uso di strumenti multipiattaforma.
+
+## Costruire un progetto
+
+Per i progetti di BlackBerry, assicurati di personalizzare il `project.properties` file nella directory radice del progetto Cordova. Devi farlo per fornire il vostro BlackBerry firma chiave password e specificare i percorsi per il BlackBerry WebWorks SDK e BlackBerry emulatore file eseguibili.
+
+ $ /path/to/my_new_project/cordova/build <platform>
+ $ /path/to/my_new_project/cordova/build.bat <platform>
+
+
+## Avviare l'emulatore
+
+Per i progetti di BlackBerry, assicurati di personalizzare il `project.properties` file nella radice della directory del progetto di Cordova. Devi farlo per fornire il vostro BlackBerry firma chiave password e specificare i percorsi per il BlackBerry WebWorks SDK e BlackBerry emulatore file eseguibili.
+
+ $ /path/to/my_new_project/cordova/run <platform>
+
+
+e poi scegliere 'no' quando richiesto con:
+
+ Avete un dispositivo BlackBerry collegato al computer? (y/n) $ /path/to/my_new_project/cordova/run < piattaforma >
+
+
+e poi scegliere 'no' quando richiesto con:
+
+ Avete un dispositivo BlackBerry collegato al computer? (y/n)
+
+
+## Registrazione
+
+Purtroppo, registri direttamente dal dispositivo in streaming è attualmente supportato. Tuttavia, BlackBerry offre supporto integrato Web Inspector per Playbook e BlackBerry dispositivi smartphone in esecuzione BlackBerry OS 7.0 e superiori. È possibile accedere anche i log dell'applicazione (compresi eventuali chiamate al `console.log` ) sul vostro dispositivo tenendo premuto il tasto 'ALT ' dalla schermata iniziale e digitando i tasti ' lglg '.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry/upgrading.md b/docs/it/3.1.0/guide/platforms/blackberry/upgrading.md
new file mode 100644
index 0000000..61bab17
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry/upgrading.md
@@ -0,0 +1,419 @@
+---
+
+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.
+---
+
+# L'aggiornamento di BlackBerry
+
+Questa guida Mostra come modificare i progetti di BlackBerry per l'aggiornamento da versioni precedenti di Cordova. Queste istruzioni si applicano ai progetti creati con un vecchio set di strumenti da riga di comando che precedono la `cordova` utilità CLI. L'interfaccia della riga di comando per informazioni, vedere come aggiornare la versione di CLI.
+
+## 2.8.0 All'aggiornamento di progetti a 2.9.0
+
+BlackBerry 10:
+
+1. Scaricare ed estrarre la sorgente di Cordova 2.9.0 a una posizione permanente sul disco rigido, ad esempio`~/Cordova-2.9.0`.
+
+2. Chiudere eventuali strumenti SDK in esecuzione: Eclipse, Momentics e simili.
+
+3. Spostarsi nella directory dove avete messo la fonte scaricata sopra, utilizzando un unix come terminal: Terminal. app, Bash, Cygwin, ecc.
+
+4. Creare un nuovo progetto, come descritto in strumenti della riga di comando di BlackBerry. Questo diventa la casa del tuo progetto aggiornato.
+
+5. Copiare il sorgente del progetto dal vecchio progetto `/www` il nuovo progetto nella directory `/www` directory.
+
+6. Aggiornare il riferimento allo script di Cordova nel tuo `www/index.html` file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo `cordova.js` file.
+
+### BlackBerryOS/Playbook
+
+1. Scaricare ed estrarre la sorgente di Cordova 2.9.0 a una posizione permanente sul disco rigido, ad esempio`~/Cordova-2.9.0`.
+
+2. Chiudere eventuali strumenti SDK in esecuzione: Eclipse, Momentics e simili.
+
+3. Spostarsi nella directory dove avete messo la fonte scaricata sopra, utilizzando un unix come terminal: Terminal. app, Bash, Cygwin, ecc.
+
+4. Creare un nuovo progetto, come descritto in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
+
+5. Copia il `www/cordova.js` file dal nuovo progetto in tuo `www` directory ed elimina il `www/cordova.js` file.
+
+6. Aggiornare il riferimento allo script di Cordova nel tuo `www/index.html` file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo `cordova.js` file.
+
+7. Copia il `native` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `native` directory.
+
+8. Copia il `lib` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `lib` directory.
+
+9. Copia il `cordova` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `cordova` directory.
+
+## All'aggiornamento 2.7.0 progetti per 2.8.0
+
+BlackBerry 10:
+
+BlackBerry 10 utilizza i nuovi utensili CLI e gestisce core API come plugin. Le istruzioni migrano il progetto per un nuovo progetto, piuttosto che aggiornare un progetto esistente, a causa della complessità di un vecchio progetto di aggiornamento. Inoltre nota che il cordova js script file ora è chiamato 'cordova.js' e più non contiene una stringa di versione.
+
+1. Scaricare ed estrarre la sorgente di Cordova 2.8.0 a una posizione permanente sul disco rigido, ad esempio`~/Cordova-2.8.0`.
+
+2. Chiudere eventuali strumenti SDK in esecuzione: Eclipse, Momentics e simili.
+
+3. Spostarsi nella directory dove avete messo la fonte scaricata sopra, utilizzando un unix come terminal: Terminal. app, Bash, Cygwin, ecc.
+
+4. Creare un nuovo progetto, come descritto in strumenti della riga di comando di BlackBerry. Questo diventa la casa del tuo progetto aggiornato.
+
+5. Copiare il sorgente del progetto dal vecchio progetto `/www` il nuovo progetto nella directory `/www` directory.
+
+6. Aggiornare il riferimento allo script di Cordova nel tuo `www/index.html` file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo `cordova.js` file.
+
+BlackBerryOS/Playbook:
+
+1. Scaricare ed estrarre la sorgente di Cordova 2.8.0 a una posizione permanente sul disco rigido, ad esempio`~/Cordova-2.8.0`.
+
+2. Chiudere eventuali strumenti SDK in esecuzione: Eclipse, Momentics e simili.
+
+3. Spostarsi nella directory dove avete messo la fonte scaricata sopra, utilizzando un unix come terminal: Terminal. app, Bash, Cygwin, ecc.
+
+4. Creare un nuovo progetto, come descritto in iOS gli strumenti della riga di comando. Avete bisogno di beni da questo nuovo progetto.
+
+5. Copia il `www/cordova.js` file dal nuovo progetto in tuo `www` directory ed elimina il `www/cordova.js` file.
+
+6. Aggiornare il riferimento allo script di Cordova nel tuo `www/index.html` file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo `cordova.js` file.
+
+7. Copia il `native` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `native` directory.
+
+8. Copia il `lib` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `lib` directory.
+
+9. Copia il `cordova` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `cordova` directory.
+
+## 2.6.0 All'aggiornamento di progetti a 2.7.0
+
+1. Scaricare ed estrarre il Cordova 2.7.0 origine a una posizione permanente sul disco rigido, ad esempio`~/Cordova-2.7.0`.
+
+2. Chiudere eventuali strumenti SDK in esecuzione: Eclipse, Momentics e simili.
+
+3. Spostarsi nella directory dove avete messo la fonte scaricata sopra, utilizzando un unix come terminal: Terminal. app, Bash, Cygwin, ecc.
+
+4. Creare un nuovo progetto, come descritto in strumenti della riga di comando di BlackBerry. Avete bisogno di beni da questo nuovo progetto.
+
+5. Copia il `www/cordova-2.7.0.js` file dal nuovo progetto in tuo `www` directory ed elimina il `www/cordova-2.6.0.js` file.
+
+6. Aggiornare il riferimento allo script di Cordova nel tuo `www/index.html` file (e qualsiasi altro file che contengono il riferimento allo script) per puntare al nuovo `cordova-2.7.0.js` file.
+
+7. Copia il `native` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `native` directory.
+
+8. Copia il `lib` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `lib` directory.
+
+9. Copia il `cordova` directory dal nuovo progetto nel progetto esistente, sovrascrivendo il vecchio `cordova` directory.
+
+## Aggiornamento a 2.6.0 da 2.5.0
+
+Aggiornando la directory di download PhoneGap:
+
+Si consiglia di scaricare una nuova copia di intere directory.
+
+Tuttavia, qui ci sono le nuove parti necessarie per l'aggiornamento a fasi:
+
+1. Aggiornare il file cordova.blackberry.js nel `Phonegap-2.6.0/lib/blackberry/javascript` directory.
+
+2. Aggiornamento del `ext` , `ext-air` , e `ext-qnx` nella `Phonegap-2.6.0/lib/blackberry/framework` directory.
+
+3. Aggiornamento del `build.xml` del file nella `Phonegap-2.6.0/lib/blackberry` directory.
+
+4. Aggiornamento del `Phonegap-2.6.0/lib/blackberry/bin` directory.
+
+5. Aggiornamento del `VERSION` del file nella `Phonegap-2.6.0/lib/blackberry` directory.
+
+Aggiornamento del `example/` directory o la migrazione di un progetto esistente:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Aggiornare il contenuto del `ext-qnx/` directory.
+
+5. Copiare il nuovo `cordova-2.6.0.js` nel vostro progetto.
+
+6. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.6.0.js` file.
+
+## Aggiornamento a 2.5.0 da 2.4.0
+
+Aggiornando la directory di download PhoneGap:
+
+Si consiglia di scaricare una nuova copia di intere directory.
+
+Tuttavia, qui ci sono le nuove parti necessarie per l'aggiornamento a fasi:
+
+1. Aggiornare il file cordova.blackberry.js nel `Phonegap-2.5.0/lib/blackberry/javascript` directory.
+
+2. Aggiornamento del `ext` , `ext-air` , e `ext-qnx` nella `Phonegap-2.5.0/lib/blackberry/framework` directory.
+
+3. Aggiornamento del `build.xml` del file nella `Phonegap-2.5.0/lib/blackberry` directory.
+
+4. Aggiornamento del `Phonegap-2.5.0/lib/blackberry/bin` directory.
+
+5. Aggiornamento del `VERSION` del file nella `Phonegap-2.5.0/lib/blackberry` directory.
+
+L'esempio di aggiornamento / directory o la migrazione di un esistente progetto:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Aggiornare il contenuto del `ext-qnx/` directory.
+
+5. Copiare il nuovo `cordova-2.5.0.js` nel vostro progetto.
+
+6. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.5.0.js` file.
+
+## Aggiornamento a 2.4.0 da 2.3.0
+
+Aggiornamento appena il `www` directory:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-2.4.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+ * Se BlackBerry 10, quindi aggiornare il file. js nella `qnx/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.4.0.js` file.
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.2.3.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.2.3.0/ext-air/` directory.
+
+4. Aggiornare il contenuto del `cordova.2.3.0/ext-qnx/` directory.
+
+5. Aggiornare il file. js nella `cordova.2.3.0/javascript/` directory.
+
+6. Aperto il `sample/lib/` directory e rinomina la `cordova.2.3.0/` nella directory`cordova.2.4.0/`.
+
+7. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+8. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.4.0.js` file.
+
+## Aggiornamento a 2.3.0 da 2.2.0
+
+Aggiornamento appena il `www` directory:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-2.3.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+ * Se BlackBerry 10, quindi aggiornare il file. js nella `qnx/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.3.0.js` file.
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.2.2.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.2.2.0/ext-air/` directory.
+
+4. Aggiornare il contenuto del `cordova.2.2.0/ext-qnx/` directory.
+
+5. Aggiornare il file. js nella `cordova.2.2.0/javascript/` directory.
+
+6. Aperto il `sample/lib/` directory e rinomina la `cordova.2.2.0/` nella directory`cordova.2.3.0/`.
+
+7. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+8. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.3.0.js` file.
+
+## Aggiornamento a 2.2.0 da 2.1.0
+
+Aggiornamento solo la directory www:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-2.2.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+ * Se BlackBerry 10, quindi aggiornare il file. js nella `qnx/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.2.0.js` file.
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.2.1.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.2.1.0/ext-air/` directory.
+
+4. Aggiornare il contenuto del `cordova.2.1.0/ext-qnx/` directory.
+
+5. Aggiornare il file. js nella `cordova.2.1.0/javascript/` directory.
+
+6. Aperto il `sample/lib/` directory e rinomina la `cordova.2.1.0/` nella directory`cordova.2.2.0/`.
+
+7. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+8. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.2.0.js` file.
+
+## Aggiornamento a 2.1.0 da 2.0.0
+
+Aggiornamento appena il `www` directory:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-2.1.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.1.0.js` file.
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.2.0.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.2.0.0/ext-air/` directory.
+
+4. Aggiornare il file. js nella `cordova.2.0.0/javascript/` directory.
+
+5. Aperto il `sample/lib/` directory e rinomina la `cordova.2.0.0/` nella directory`cordova.2.1.0/`.
+
+6. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+7. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.1.0.js` file.
+
+## Aggiornamento a 2.0.0 da 1.9.0
+
+Aggiornamento appena il `www` directory:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-2.0.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.0.0.js` file.
+
+6. Aggiornamento tuo `www/plugins.xml` file. Due plugin cambiato la loro etichetta di servizio/spazio dei nomi. Cambiare le vecchie voci per i plugin di cattura e di contatto da:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.media.MediaCapture"/ >< plugin nome = "Contatto" value="org.apache.cordova.pim.Contact"/ >
+
+
+ A:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.capture.MediaCapture"/ >< nome del plugin = value="org.apache.cordova.pim.Contact"/ "Contatti" >
+
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.1.9.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.1.9.0/ext-air/` directory.
+
+4. Aggiornare il file. js nella `cordova.1.9.0/javascript/` directory.
+
+5. Aperto il `sample/lib/` directory e rinomina la `cordova.1.9.0/` nella directory`cordova.2.0.0/`.
+
+6. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+7. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-2.0.0.js` file.
+
+8. Aperto il `www/` directory e aggiornamento del `plugins.xml` file. Due plugin cambiato la loro etichetta di servizio/spazio dei nomi. Cambiare le vecchie voci per i plugin di cattura e di contatto da:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.media.MediaCapture"/ >< plugin nome = "Contatto" value="org.apache.cordova.pim.Contact"/ >
+
+
+ A:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.capture.MediaCapture"/ >< nome del plugin = value="org.apache.cordova.pim.Contact"/ "Contatti" >
+
+
+* Per aggiornare a 1.8.0, si prega di andare da 1.7.0
+
+## Aggiornamento a 1.8.0 da 1.7.0
+
+Aggiornamento appena il `www` directory:
+
+1. Aperto il `www/` directory che contiene la tua app.
+
+2. Rimuovere e aggiornare il file. jar nella `ext/` directory.
+
+3. Aggiornare il contenuto del `ext-air/` directory.
+
+4. Copiare il nuovo `cordova-1.8.0.js` nel vostro progetto.
+
+ * Se playbook, quindi aggiornamento il js file nella `playbook/` directory.
+
+5. Aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.8.0.js` file.
+
+6. Aggiornamento tuo `www/plugins.xml` file. Due plugin cambiato la loro etichetta di servizio/spazio dei nomi. Cambiare le vecchie voci per i plugin di cattura e di contatto da:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.media.MediaCapture"/ >< plugin nome = "Contatto" value="org.apache.cordova.pim.Contact"/ >
+
+
+ A:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.capture.MediaCapture"/ >< nome del plugin = value="org.apache.cordova.pim.Contact"/ "Contatti" >
+
+
+Aggiornando la directory di esempio (cioè, aggiornamento utilizzando gli strumenti della formica):
+
+1. Aperto il `sample/lib/` directory.
+
+2. Aggiornare il file. jar nella `cordova.1.7.0/ext/` directory.
+
+3. Aggiornare il contenuto del `cordova.1.7.0/ext-air/` directory.
+
+4. Aggiornare il file. js nella `cordova.1.7.0/javascript/` directory.
+
+5. Aperto il `sample/lib/` directory e rinomina la `cordova.1.7.0/` nella directory`cordova.1.8.0/`.
+
+6. Tipo `ant blackberry build` o `ant playbook build` per aggiornare il `www/` directory con Cordova aggiornato.
+
+7. Aperto il `www/` directory e aggiorna il tuo HTML per utilizzare il nuovo `cordova-1.8.0.js` file.
+
+8. Aperto il `www/` directory e aggiornamento del `plugins.xml` file. Due plugin cambiato la loro etichetta di servizio/spazio dei nomi. Cambiare le vecchie voci per i plugin di cattura e di contatto da:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.media.MediaCapture"/ >< plugin nome = "Contatto" value="org.apache.cordova.pim.Contact"/ >
+
+
+ A:
+
+ < nome plugin = "Cattura" value="org.apache.cordova.capture.MediaCapture"/ >< nome del plugin = value="org.apache.cordova.pim.Contact"/ "Contatti" >
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry10/config.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry10/config.md b/docs/it/3.1.0/guide/platforms/blackberry10/config.md
new file mode 100644
index 0000000..7fc56e9
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry10/config.md
@@ -0,0 +1,33 @@
+---
+
+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.
+---
+
+# Configurazione di blackBerry
+
+La `config.xml` file controlla le impostazioni di base di un'app che si applicano a ogni applicazione e istanza di CordovaWebView. Le preferenze di dettagli questa sezione che si applicano solo a BlackBerry 10 costruisce. Vedere il file config. XML File per informazioni sulle opzioni di configurazione globale.
+
+* `ChildBrowser`( `disable` o default `enable` ): disattiva windows browser bambino. Per impostazione predefinita, apps lanciare una finestra del browser secondario per visualizzare risorse accessibili tramite `window.open()` o specificando un `_blank` obiettivo di ancoraggio. Specificare `disable` per eseguire l'override di questo comportamento predefinito.
+
+ <preference name="ChildBrowser" value="disable"/>
+
+
+* `PopupBlocker`( `enable` o default `disable` ): consente il blocco dei popup, che impedisce che le chiamate a `window.open()` . Per impostazione predefinita, popup visualizzano in una finestra del browser di bambino. L'impostazione della preferenza `enable` impedisce la visualizzazione a tutti.
+
+ <preference name="PopupBlocker" value="enable"/>
+
+
+* `WebSecurity`( `disable` o default `enable` ): impostare su `disable` per ignorare le impostazioni di protezione web, consentendo l'accesso ai contenuti remoti da fonti sconosciute. Questa preferenza è inteso come una comodità di sviluppo solo, quindi rimuoverla prima app per la distribuzione di imballaggio. Per l'app rilasciata, tutti gli URI devono essere conosciuto e whitelisted utilizzando il `<access>` elemento, descritto nella guida alla Whitelist di dominio.
+
+ <preference name="WebSecurity" value="disable"/>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry10/index.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry10/index.md b/docs/it/3.1.0/guide/platforms/blackberry10/index.md
new file mode 100644
index 0000000..5730191
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry10/index.md
@@ -0,0 +1,174 @@
+---
+
+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.
+---
+
+# Guida piattaforma blackBerry 10
+
+Questa guida illustra come impostare il vostro ambiente di sviluppo per creare e distribuire applicazioni di Cordova per dispositivi BlackBerry 10. Per le precedenti versioni di BlackBerry, è necessario utilizzare un diverso insieme di strumenti da riga di comando, descritti nella guida piattaforma BlackBerry.
+
+## Requisiti
+
+L'ambiente di sviluppo è disponibile su Windows, Mac e Linux.
+
+Gli sviluppatori devono utilizzare il `cordova` utilità in combinazione con il SDK nativo Blackberry. L'interfaccia della riga di comando per informazioni, vedere come installare `cordova` , aggiungere progetti, quindi creare e distribuire per ogni piattaforma.
+
+## Installare il SDK nativo BlackBerry
+
+il SDK nativo BlackBerry è disponibile da [developer.blackberry.com][1]. Dopo l'installazione, è necessario aggiungere i suoi strumenti da riga di comando al vostro percorso di sistema.
+
+ [1]: http://developer.blackberry.com/native/download/
+
+Su Windows:
+
+* Andare al **mio Computer → proprietà → avanzate → variabili di ambiente**.
+
+* Aggiungere la directory di installazione di SDK nativo al percorso, ad esempio:
+
+ ;C:\bbndk\host\_10\_1\_0\_132\darwin\x86\usr\bin\
+
+Su Mac e Linux:
+
+* Modificare il `~/.bash_profile` file, aggiungendo una riga come la seguente, a seconda di dove è stato installato il SDK nativo:
+
+ esportazione $ PATH = ${PATH}: / applicazioni/bbndk/host\_10\_1\_0\_132/darwin/x86/usr/bin /
+
+ o per il SDK nativo 10.2:
+
+ esportazione di $ PATH=${PATH}:/Applications/Momentics.app/host\_10\_2\_0\_15/darwin/x86/usr/bin/
+
+* Eseguire le operazioni seguenti per applicare la modifica nella sessione corrente:
+
+ $ fonte ~/.bash_profile
+
+## Istituito per firma
+
+Se si desidera testare su un dispositivo o distribuire applicazioni attraverso BlackBerry World, il sistema deve essere setup per la firma del codice.
+
+Per ottenere una chiave di firma, visitare il sito Web di BlackBerry e assicurarsi di mantenere la password specificata. Quindi eseguire il `blackberry-signer` utilità che è incluso con il SDK nativo BlackBerry.
+
+Istruzioni dettagliate possono essere trovate qui:
+
+* [Registrati per il codice chiave di firma.][2]
+
+* [Configurare il sistema per la firma del codice.][3]
+
+ [2]: https://www.blackberry.com/SignedKeys/codesigning.html
+ [3]: https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html
+
+## Creare un progetto
+
+Uso il `cordova` utility per impostare un nuovo progetto, come descritto in l'interfaccia della riga di comando. Ad esempio, in una directory del codice sorgente:
+
+ $ cordova creare Ciao com.example.hello $ cd $ Ciao cordova piattaforma aggiungere compilazione di cordova $ blackberry10
+
+
+## Distribuire all'emulatore
+
+Se si desidera eseguire un emulatore del dispositivo, scaricare e installare il BlackBerry 10 simulatore.
+
+* [Scarica][1]
+* [Guida introduttiva][4]
+
+ [4]: http://developer.blackberry.com/devzone/develop/simulator/blackberry_10_simulator_start.html
+
+Prima di testare un'app su un emulatore o un dispositivo, è necessario aggiungere una *destinazione* al progetto. Ognuno è identificato con un nome univoco e associato a un indirizzo IP. È necessario ottenere l'indirizzo IP dall'emulatore prima di utilizzarlo per visualizzare applicazioni.
+
+Lanciare l'immagine di emulatore, quindi scegliere **Impostazioni** dalla schermata iniziale:
+
+![][5]
+
+ [5]: img/guide/platforms/blackberry10/bb_home.png
+
+Passare al **sicurezza e Privacy → modalità di sviluppo** sezione, attivare l'opzione e ottenere l'indirizzo IP:
+
+![][6]
+
+ [6]: img/guide/platforms/blackberry10/bb_devel.png
+
+Un ulteriore insieme di utilità della riga di comando sono inclusi quando si configura la piattaforma BlackBerry 10 per il progetto. Il comando riportato di seguito, in questo caso richiamato dalla directory principale del progetto, associa una destinazione denominata *UEM* con l'indirizzo IP visualizzato sopra.
+
+* Su Windows:
+
+ $ platforms\blackberry10\cordova\target.bat aggiungere simulatore di emu 169.254.0.1 -t
+
+* Su Mac/Linux:
+
+ $ piattaforme/blackberry10/cordova/destinazione aggiungere simulatore di emu 169.254.0.1 -t
+
+Quindi, eseguire il `emulate` comando per visualizzare l'app:
+
+ $ cordova emulare blackberry10
+
+
+## Distribuire al dispositivo
+
+Per distribuire un dispositivo, assicurarsi che sia collegato al computer. Abilitare la modalità di sviluppo e ottenere l'indirizzo IP come desribed nella sezione emulatore precedente. Sarà inoltre necessario ottenere il PIN dall'applicazione **Impostazioni** sotto **circa → Hardware**:
+
+![][7]
+
+ [7]: img/guide/platforms/blackberry10/bb_pin.png
+
+Eseguire l'utilità della riga di destinazione per associare un nome a un indirizzo IP, password dispositivo e PIN.
+
+* Su Windows:
+
+ $ platforms\blackberry10\cordova\target.bat aggiungere mydevice 169.254.0.1 dispositivo di -t - password 123456 - perno FFFF972E
+
+* Su Mac/Linux:
+
+ $ piattaforme/blackberry10/cordova/destinazione aggiungere mydevice 169.254.0.1 dispositivo di -t - password 123456 - perno FFFF972E
+
+dove:
+
+* `--password`si riferisce alla password per sbloccare il dispositivo.
+
+* `--pin`si riferisce al dispositivo PIN ottenuti dall'applicazione **Impostazioni** .
+
+Quindi, eseguire il `run` comando per visualizzare l'app:
+
+ $ cordova eseguire blackberry10
+
+
+Se un token di debug non è ancora impostato per il dispositivo, un messaggio di errore richiede di utilizzare la piattaforma di eseguire script con la password che hai fornito durante la registrazione per chiavi di firma.
+
+* Su Windows:
+
+ $ platforms\blackberry10\cordova\run.bat - dispositivo - keystorepass mysecret
+
+* Su Mac/Linux:
+
+ $ piattaforme/blackberry10/cordova/run - dispositivo - keystorepass mysecret
+
+## Debug con WebInspector
+
+Quando il debug sul dispositivo o un emulatore, è possibile eseguire WebInspector in remoto per visualizzare lo stato interno dell'applicazione. Un prompt dei comandi viene visualizzato l'URL che consente di connettersi all'app con un browser web standard. Per ulteriori informazioni, vedere [debug utilizzando WebInspector][8].
+
+ [8]: http://developer.blackberry.com/html5/documentation/web_inspector_overview_1553586_11.html
+
+## Costruzione di una versione di rilascio
+
+Per impostazione predefinita, esegue il `cordova build` comando crea un file di pacchetto non firmato *bar* adatto per il test su un dispositivo o un simulatore.
+
+È necessario eseguire una diversa `build` comando per creare una versione non adatta per la distribuzione attraverso il mondo BlackBerry. Non fa affidamento sul `cordova` strumento CLI e invece utilizza la seguente sintassi:
+
+* Su Windows:
+
+ $ platforms\blackberry10\cordova\build.bat - rilascio - keystorepass mysecret
+
+* Su Mac/Linux:
+
+ $ piattaforme/blackberry10/cordova/build--rilascio - keystorepass mysecret
+
+Il `--keystorepass` opzione specifica la password che definito quando si configura il computer per firmare applicazioni.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/2b8e503f/docs/it/3.1.0/guide/platforms/blackberry10/plugin.md
----------------------------------------------------------------------
diff --git a/docs/it/3.1.0/guide/platforms/blackberry10/plugin.md b/docs/it/3.1.0/guide/platforms/blackberry10/plugin.md
new file mode 100644
index 0000000..b2bb8d2
--- /dev/null
+++ b/docs/it/3.1.0/guide/platforms/blackberry10/plugin.md
@@ -0,0 +1,155 @@
+---
+
+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.
+---
+
+# BlackBerry 10 plugin
+
+Questa è una continuazione della guida sviluppo Plugin per Cordova. Una volta che si hanno esaminato tale contenuto, ora facciamo guardare le cose che abbiamo bisogno di avere il plugin di Echo per la piattaforma BlackBerry 10. Ricordiamo che il plugin Echo restituisce praticamente qualunque stringa un utente fornisce per la `window.echo` funzione:
+
+ window.echo = function(str, callback) {
+ cordova.exec(callback, function(err) {
+ callback('Nothing to echo.');
+ }, "Echo", "echo", [str]);
+ };
+
+
+Un nativo BlackBerry 10 plugin per Cordova contiene codice JavaScript e possa contenere anche codice nativo. L'esempio di plugin Echo viene illustrato come richiamare le funzionalità native da JavaScript. Native e codice JavaScript comunicano tra loro attraverso un quadro fornito da JNEXT. Ogni plugin deve includere anche un `plugin.xml` file.
+
+## Creazione parte nativa del vostro plugin
+
+Per creare la parte nativa del vostro plugin, aprire il BlackBerry 10 NDK IDE e selezionare il File > New > BlackBerry progetto > estensione nativa > BlackBerry WebWorks. Immettere il nome del progetto desiderato / posizione e fare clic su fine.
+
+Il progetto creato dall'IDE contiene codice di esempio per un plugin di memoria. Si può sostituire o modificare questi file per includere funzionalità personalizzate.
+
+* `*name*_js.hpp`: Intestazione C++ per il codice JNEXT.
+
+* `*name*_js.cpp`: Codice C++ per JNEXT.
+
+L'interfaccia nativa per l'estensione JNEXT può essere visualizzato nel file di intestazione plugin nella directory pubblica del vostro progetto. Inoltre contiene costanti e funzioni di utilità che possono essere utilizzati nel codice nativo. Il plugin deve essere derivato da JSExt che è definito in plugin.h. Cioè, è necessario implementare la seguente classe:
+
+ JSExt di classe {public: virtual ~JSExt() {};
+ virtuale stringa InvokeMethod (const string & strCommand) = 0;
+ Virtual bool CanDelete (void) = 0;
+ privato: m_id std:: String;
+ };
+
+
+Pertanto, l'estensione deve includere il file di intestazione plugin.h. Nell'esempio di Echo, si utilizza JSExt come segue nel file echo_js.hpp:
+
+ #include ".../ public/plugin.h "#include < string > #ifndef ECHO_JS_H_ #define ECHO_JS_H_ classe Echo: pubblica JSExt {pubblica: Echo esplicita (const std:: String & id);
+ Virtual ~ echo ();
+ std:: String virtuale InvokeMethod (const std:: String & comando);
+ Virtual bool CanDelete();
+ privato: m_id std:: String;
+ };
+
+ #endif / / ECHO_JS_H_
+
+
+Il `m_id` è un attributo che contiene l'id JNEXT per questo oggetto. L'id viene passato alla classe come argomento al costruttore. È necessario attivare eventi sul lato JavaScript da codice nativo. Il metodo di CanDelete è utilizzato da JNEXT per determinare se il vostro oggetto nativo può essere eliminato. La funzione InvokeMethod è chiamata come risultato da una richiesta da JavaScript per richiamare un metodo di questo particolare oggetto. L'unico argomento a questa funzione è una stringa passata da JavaScript che questo metodo dovrebbe analizzare al fine di determinare quale metodo dell'oggetto nativo deve essere eseguito. Ora abbiamo implementare queste funzioni in echo_js.cpp. Per l'esempio di Echo, implementiamo InvokeMethod funzione come segue:
+
+ String Echo::InvokeMethod (const string & comando) {//parse comando e args dall'indice di stringa int = command.find_first_of("");
+ String strCommand = command.substr (0, indice);
+ String strValue = command.substr (indice + 1, command.length());
+
+ / / Determinare quale funzione dovrebbe essere eseguita se (strCommand = = "echo") {return strValue;
+ } else {return "Metodo non supportato";
+ }
+ }
+
+
+Il vostro plugin nativo deve implementare anche le seguenti funzioni di callback:
+
+* `extern char * onGetObjList (void);`
+
+* `extern JSExt * onCreateObject (const string & strClassName, const string & strObjId);`
+
+il `onGetObjList` funzione restituisce un elenco separato da virgole delle classi supportate da JNEXT. JNEXT utilizza questa funzione per determinare il set di classi che è possibile creare un'istanza di JNEXT. Nel nostro plugin Echo, abbiamo il seguente `echo_js.cpp` :
+
+ char * onGetObjList() {static char nome [] = "Echo";
+ restituire il nome;
+ }
+
+
+il `onCreateObject` funzione accetta due parametri. Il primo parametro è il nome della classe che ha chiesto di essere creato dal lato JavaScript. Nomi validi sono quelli restituiti in `onGetObjList` . Il secondo parametro è l'id di oggetto univoco per la classe. Questo metodo restituisce un puntatore all'oggetto plugin creato. Nel nostro plugin Echo, abbiamo il seguente `echo_js.cpp` :
+
+ JSExt * onCreateObject (const string & className, const string & id) {se (className = = "Echo") {return nuovo Echo(id);
+ } return NULL;
+ }
+
+
+## Creare la parte di JavaScript del vostro plugin
+
+La parte di JavaScript del vostro plugin deve contenere i seguenti file:
+
+* `client.js`: Questo è considerato il lato client e contiene le API che si può chiamare un'applicazione di Cordova. L'API in `client.js` chiamate effettua chiamate al `index.js` . L'API in `client.js` collega inoltre funzioni di callback agli eventi che fuoco i callback.
+
+* `index.js`: Cordova carica `index.js` e rende accessibile attraverso il ponte di cordova.exec. La `client.js` file effettua chiamate all'API nella `index.js` file, che a sua volta chiamare al JNEXT per comunicare con il lato nativo.
+
+Il lato client e server ( `client.js` e `index.js` ) interagisce tramite la `Cordova.exec` funzione. Così, in `client.js` si richiama il `exec` di funzione di fornire gli argomenti necessari. Nel plugin Echo, abbiamo seguito nella `client.js` file:
+
+ var service = "org.apache.cordova.blackberry.echo",
+ exec = cordova.require("cordova/exec");
+
+ module.exports = {
+ echo: function (data, success, fail) {
+ exec(success, fail, service, "echo", { data: data });
+ }
+ };
+
+
+Ora, `index.js` interagisce con il lato nativo utilizzando JNEXT. Così allegare una funzione costruttore denominata eco a JNEXT. All'interno del costruttore è eseguire le seguenti operazioni chiave utilizzando la funzione init:
+
+* Specificare il modulo richiesto esportato dal lato nativo. Il nome del modulo richiesto deve corrispondere al nome di un file di libreria condivisa (file. so).
+
+`JNEXT.require("libecho")`
+
+* Creare un oggetto utilizzando un modulo acquisito e salvare l'ID che viene restituito dalla chiamata. self.m_Id = JNEXT.createObject ("libecho.Echo"); Quando l'applicazione chiama la funzione echo in `client.js` , che a sua volta chiamata chiama la funzione echo in `index.js` , dove l'oggetto PluginResult invia una risposta (dati) a `client.js` . Poiché l'argomento args passato le funzioni è stato convertito da JSON.stringfy() e codificato come un componente URI, è necessario chiamare il seguente:
+
+`dati = JSON.parse(decodeURIComponent(args.data));`
+
+È ora possibile inviare i dati indietro. Mettiamolo tutti insieme:
+
+ module.exports = {
+
+ echo: function (success, fail, args, env) {
+
+ var result = new PluginResult(args, env),
+ data = JSON.parse(decodeURIComponent(args.data)),
+ response = echo.getInstance().echo(data);
+ result.ok(response, false);
+ }
+ };
+
+
+## Architettura del plugin
+
+È possibile posizionare i manufatti del plugin, che comprende il `plugin.xml` file, i file di origine (JavaScript, C++) e i file binari ( `.so` ) all'interno di qualsiasi struttura di directory, finchè si specificano correttamente i percorsi dei file nella `plugin.xml` file. Una tipica struttura assomiglia a questo:
+
+***your\_project\_directory*** (> plugin)
+
+* **www** (> client.js)
+* **src**
+ * **blackberry10** (> index.js, **nativa** > *.cpp, *.hpp)
+ * **dispositivo** (>*binario file* *. so)
+ * **simulatore** (>*binario file* *. so)
+
+(L'elenco Mostra la relazione gerarchica tra le directory di livello superiore. La parentesi indica il contenuto di una directory specificata. Tutti i nomi di directory vengono visualizzati in grassetto. I nomi dei file sono preceduti dalla `>` segno.)
+
+## Contenuto della `plugin.xml` file
+
+La `plugin.xml` file contiene lo spazio dei nomi di estensione e altri metadati. Definire lo spazio dei nomi e specificare altri metadati per il plugin Echo come segue:
+
+ < plugin xmlns = "http://www.phonegap.com/ns/plugins/1.0" id="org.apache.cordova.blackberry.echo" versione = "1.0.0" >< js-modulo src = "www/client.js" >< unioni destinazione = "navigator" / >< / js-modulo >< nome piattaforma = "blackberry10" >< file di origine src="src/blackberry10/index.js" / >< lib-file src="src/blackberry10/native/device/libecho.so" arco = "dispositivo" / >< lib-file src="src/blackberry10/native/simulator/libecho.so" arco = "simulator" / >< bersaglio-config-file = "www/config.xml" padre = "/ widget" >< presentano name="org.apache.cordova.blackberry.echo" value="org.apache.cordova.blackberry.echo" / >< / config-file >< /piattaforma >< / plugin >
\ No newline at end of file