cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [25/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:27:41 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/parameters/display_name.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/parameters/display_name.md b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/display_name.md
new file mode 100644
index 0000000..2087956
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/display_name.md
@@ -0,0 +1,25 @@
+---
+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.
+
+title: database_displayname
+---
+
+# database_displayname
+
+顯示資料庫的名稱。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/parameters/name.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/parameters/name.md b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/name.md
new file mode 100644
index 0000000..c72d2f3
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/name.md
@@ -0,0 +1,25 @@
+---
+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.
+
+title: database_name
+---
+
+# database_name
+
+資料庫的名稱。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/parameters/size.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/parameters/size.md b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/size.md
new file mode 100644
index 0000000..0df07db
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/size.md
@@ -0,0 +1,25 @@
+---
+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.
+
+title: database_size
+---
+
+# database_size
+
+以位元組為單位的資料庫的大小。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/parameters/version.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/parameters/version.md b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/version.md
new file mode 100644
index 0000000..e0a8a3b
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/parameters/version.md
@@ -0,0 +1,25 @@
+---
+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.
+
+title: database_version
+---
+
+# database_version
+
+資料庫的版本。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/sqlerror/sqlerror.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/sqlerror/sqlerror.md b/www/docs/zh-cn/5.4.0/cordova/storage/sqlerror/sqlerror.md
new file mode 100644
index 0000000..67e2199
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/sqlerror/sqlerror.md
@@ -0,0 +1,46 @@
+---
+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.
+
+title: SQLError
+---
+
+# SQLError
+
+A `SQLError` 物件當發生錯誤時引發。
+
+## 屬性
+
+*   **代碼**: 下面列出的預定義的錯誤代碼之一。
+
+*   **消息**: 錯誤的說明。
+
+## 常量
+
+*   `SQLError.UNKNOWN_ERR`
+*   `SQLError.DATABASE_ERR`
+*   `SQLError.VERSION_ERR`
+*   `SQLError.TOO_LARGE_ERR`
+*   `SQLError.QUOTA_ERR`
+*   `SQLError.SYNTAX_ERR`
+*   `SQLError.CONSTRAINT_ERR`
+*   `SQLError.TIMEOUT_ERR`
+
+## 說明
+
+`SQLError`物件運算元據庫時出現錯誤時引發。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultset/sqlresultset.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultset/sqlresultset.md b/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultset/sqlresultset.md
new file mode 100644
index 0000000..b8efb5c
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultset/sqlresultset.md
@@ -0,0 +1,59 @@
+---
+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.
+
+title: SQLResultSet
+---
+
+# SQLResultSet
+
+當 `[SQLTransaction](../sqltransaction/sqltransaction.html)` 物件的 `executeSql` 方法時,執行指定的回檔 `SQLResultSet` 參數。
+
+## 屬性
+
+*   **insertId**: 行的行的 ID, `SQLResultSet` 物件的 SQL 語句插入到資料庫中。
+
+*   **rowsAffected**: 由零如果該語句不會影響任何行的 SQL 語句更改的行數。
+
+*   **行**: `[SQLResultSetRowList](../sqlresultsetrowlist/sqlresultsetrowlist.html)` 表示返回的行,如果未返回行,則為空。
+
+## 詳細資訊
+
+當 `[SQLTransaction](../sqltransaction/sqltransaction.html)` 物件的 `executeSql` 方法時,執行指定的回檔 `SQLResultSet` 參數,其中包含三個屬性:
+
+*   `insertId`返回組裝成功的 SQL 插入語句的行號。如果 SQL 不會插入任何行, `insertId` 未設置。
+
+*   `rowsAffected`始終是 `` 為一個 SQL `select` 語句。為 `insert` 或 `update` 它返回的數的語句修改的行。
+
+*   決賽 `SQLResultSetList` 包含從一個 SQL select 語句返回的資料。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 6.0 和更高)
+*   iOS
+*   Tizen
+
+## 執行 SQL 快速示例
+
+    函數 queryDB(tx) {tx.executeSql (' 選擇 * 從演示 '、 []、 querySuccess、 errorCB);}函數 querySuccess (德克薩斯州,結果) {console.log ("返回行 ="+ results.rows.length) ;/ / 這將是真實的因為這是一條 select 語句,所以 rowsAffected 是 0,如果 (! results.rowsAffected) {console.log ('沒有行受影響!') ;返回 false ;} / / 的 insert 語句,此屬性將返回的最後插入的行 console.log 的 ID ("最後插入的行 ID ="+ results.insertId);}函數 errorCB(err) {警報 ("處理 SQL 時出錯:"+ err.code);}var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction errorCB queryDB) ;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html >< html >< 頭 >< 標題 > 存儲示例 < / 標題 >< 腳本類型 ="文本/javascript"charset ="utf 8"src="cordova.js">< / 腳本 >< 腳本類型 ="文本/javascript"charset ="utf 8"> / / 等待設備 API 庫載入 / / document.addEventListener ("deviceready",onDeviceReady,false);/ / 填充資料庫 / / 函數 populateDB(tx) {tx.executeSql ('下拉表如果存在演示') ;tx.executeSql (' 創建表如果不存在演示 (id 唯一的資料) ') ;tx.executeSql (' 的值插入到演示 (id、 資料) (1,"第一行") ') ;tx.executeSql (插入到演示 (id、 資料) 值 (2,"第二行")) ;} / / 查詢資料庫 / / 函數 queryDB(tx) {tx.executeSql (' 選擇 * 從演示 '、 []、 querySuccess、 errorCB) ;} / / 查詢成功回檔 / / 函數 querySuccess (德克薩斯州,結果) {console.log ("返回行 ="+ results.rows.length) ;/ / 這將是真實的因為這是一條 select 語句,所以 rowsAffected 是 0,如果 (
 ! results.rowsAffected) {console.log ('沒有行受影響!') ;返回 false ;} / / 的 insert 語句,此屬性將返回的最後插入的行 console.log 的 ID ("最後插入的行 ID ="+ results.insertId) ;} / / 交易錯誤回檔 / / 函數 errorCB(err) {console.log ("處理 SQL 時出錯:"+ err.code) ;} / / 交易成功回檔 / / 函數 successCB() {var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction errorCB queryDB) ;} / / 設備的 Api 可 / / 函數 onDeviceReady() {var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction (populateDB、 errorCB、 successCB) ;} < / 腳本 >< / 頭 >< 身體 >< h1 > 示例 < / h1 >< p > 資料庫 </p >< / 身體 >< / html >
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md b/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md
new file mode 100644
index 0000000..dea416d
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md
@@ -0,0 +1,53 @@
+---
+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.
+
+title: SQLResultSetRowList
+---
+
+# SQLResultSetRowList
+
+屬性之一的 `[SQLResultSet](../sqlresultset/sqlresultset.html)` 從 SQL 查詢中包含的行返回。
+
+## 屬性
+
+*   **長度**: SQL 查詢所返回的行數。
+
+## 方法
+
+*   **專案**: 返回 JavaScript 物件所表示的指定索引處的行。
+
+## 詳細資訊
+
+`SQLResultSetRowList`包含從 SQL 返回的資料 `select` 語句。 該物件包含 `length` 屬性,該值多少行 `select` 語句返回。 若要獲取的資料行,調用 `item` 方法,以指定一個索引。 它返回 JavaScript `Object` 其屬性是的資料庫列 `select` 反對執行語句。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 6.0 和更高)
+*   iOS
+*   Tizen
+
+## 執行 SQL 快速示例
+
+    函數 queryDB(tx) {tx.executeSql (' 選擇 * 從演示 '、 []、 querySuccess、 errorCB);}函數 querySuccess (德克薩斯州,結果) {var len = results.rows.length ;console.log ("演示表:"+ len +"行發現") ;為 (var 我 = 0 ; 我 < len ; i + +) {console.log ("行 ="+ i +"ID ="+ results.rows.item (i).id +"的資料 ="+ results.rows.item(i).data) ;}} 函數 errorCB(err) {警報 ("處理 SQL 時出錯:"+ err.code) ;} var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction errorCB queryDB) ;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html >< html >< 頭 >< 標題 > 存儲示例 < / 標題 >< 腳本類型 ="文本/javascript"charset ="utf 8"src="cordova.js">< / 腳本 >< 腳本類型 ="文本/javascript"charset ="utf 8"> / / 等待設備 API 庫載入 / / document.addEventListener ("deviceready",onDeviceReady,false);/ / 填充資料庫 / / 函數 populateDB(tx) {tx.executeSql ('下拉表如果存在演示') ;tx.executeSql (' 創建表如果不存在演示 (id 唯一的資料) ') ;tx.executeSql (' 的值插入到演示 (id、 資料) (1,"第一行") ') ;tx.executeSql (插入到演示 (id、 資料) 值 (2,"第二行")) ;} / / 查詢資料庫 / / 函數 queryDB(tx) {tx.executeSql (' 選擇 * 從演示 '、 []、 querySuccess、 errorCB) ;} / / 查詢成功回檔 / / 函數 querySuccess (德克薩斯州,結果) {var len = results.rows.length ;console.log ("演示表:"+ len +"行發現") ;為 (var 我 = 0 ; 我 < len ; i + +) {console.log ("行 ="+
  i +"ID ="+ results.rows.item (i).id +"的資料 ="+ results.rows.item(i).data) ;}} / / 交易錯誤回檔 / / 函數 errorCB(err) {console.log ("處理 SQL 時出錯:"+ err.code) ;} / / 交易成功回檔 / / 函數 successCB() {var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction errorCB queryDB) ;} / / 設備的 Api 可 / / 函數 onDeviceReady() {var db = window.openDatabase ("資料庫"、"1.0","科爾多瓦演示",200000) ;db.transaction (populateDB、 errorCB、 successCB) ;} < / 腳本 >< / 頭 >< 身體 >< h1 > 示例 < / h1 >< p > 資料庫 </p >< / 身體 >< / html >
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/sqltransaction/sqltransaction.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/sqltransaction/sqltransaction.md b/www/docs/zh-cn/5.4.0/cordova/storage/sqltransaction/sqltransaction.md
new file mode 100644
index 0000000..ab577ba
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/sqltransaction/sqltransaction.md
@@ -0,0 +1,111 @@
+---
+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.
+
+title: SQLTransaction
+---
+
+# SQLTransaction
+
+允許對資料庫的 SQL 語句的執行。
+
+## 方法
+
+*   **executeSql**: 執行一個 SQL 語句。
+
+## 詳細資訊
+
+調用 `Database` 物件的交易方法,刀路 `SQLTransaction` 指定的回檔方法的物件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 6.0 和更高)
+*   iOS
+*   Tizen
+
+## 執行 SQL 快速示例
+
+    function populateDB(tx) {
+        tx.executeSql('DROP TABLE IF EXISTS DEMO');
+        tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
+        tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
+        tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
+    }
+    
+    function errorCB(err) {
+        alert("Error processing SQL: "+err);
+    }
+    
+    function successCB() {
+        alert("success!");
+    }
+    
+    var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000);
+    db.transaction(populateDB, errorCB, successCB);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Storage Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000);
+            db.transaction(populateDB, errorCB, successCB);
+        }
+    
+        // Populate the database
+        //
+        function populateDB(tx) {
+            tx.executeSql('DROP TABLE IF EXISTS DEMO');
+            tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
+            tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
+            tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
+        }
+    
+        // Transaction error callback
+        //
+        function errorCB(err) {
+            alert("Error processing SQL: "+err);
+        }
+    
+        // Transaction success callback
+        //
+        function successCB() {
+            alert("success!");
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>SQLTransaction</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/storage.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/storage.md b/www/docs/zh-cn/5.4.0/cordova/storage/storage.md
new file mode 100644
index 0000000..ba77d2c
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/storage.md
@@ -0,0 +1,68 @@
+---
+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.
+
+title: 存儲
+---
+
+# 存儲
+
+> 科爾多瓦的存儲選項的概述。
+
+幾個存儲 Api 是對科爾多瓦應用程式可用。請參閱 [html5rocks][1]。有關更完整的概述和示例。
+
+ [1]: http://www.html5rocks.com/en/features/storage
+
+## 認為
+
+此 API 也已知作為*web 存儲*、*簡單的存儲*,或由其備用*會話存儲*介面,提供同步鍵/值對存儲,是可用基礎 web 視圖實現中。 請參閱[W3C 規範][2]的詳細資訊。
+
+ [2]: http://www.w3.org/TR/webstorage/
+
+## WebSQL
+
+此 API 是在底層 web 視圖中可用。 [Web SQL 資料庫規範][3]提供了更多的功能全面的資料庫表可以通過 SQL 查詢訪問。
+
+ [3]: http://dev.w3.org/html5/webdatabase/
+
+以下平臺支援 WebSQL:
+
+*   Android 系統
+*   黑莓 10
+*   iOS
+*   Tizen
+
+## IndexedDB
+
+此 API 是在底層 web 視圖中可用。[索引 DB][4]提供更多的功能比 LocalStorage 但較少比 WebSQL。
+
+ [4]: http://www.w3.org/TR/IndexedDB/
+
+以下平臺支援 IndexedDB:
+
+*   黑莓 10
+*   火狐瀏覽器的作業系統
+*   Windows Phone 8
+*   Windows 8
+
+## 基於外掛程式的選項
+
+除了上面列出的 Api 的存儲,[檔 API][5]允許您對本地檔案系統上的緩存資料。 其他的[科爾多瓦外掛程式][6]提供類似的存儲選項。
+
+ [5]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md
+ [6]: http://plugins.cordova.io/
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/cordova/storage/storage.opendatabase.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/cordova/storage/storage.opendatabase.md b/www/docs/zh-cn/5.4.0/cordova/storage/storage.opendatabase.md
new file mode 100644
index 0000000..13dad8a
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/cordova/storage/storage.opendatabase.md
@@ -0,0 +1,72 @@
+---
+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.
+
+title: 大概
+---
+
+# 大概
+
+返回一個新的 `Database` 物件。
+
+    var dbShell = window.openDatabase(database_name, database_version, database_displayname, database_size);
+    
+
+## 說明
+
+方法創建一個新的 SQL Lite 資料庫並返回 `Database` 允許對資料進行操作的物件。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 6.0 和更高)
+*   iOS
+*   Tizen
+
+## 快速的示例
+
+    var db = window.openDatabase("test", "1.0", "Test DB", 1000000);
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Storage Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var db = window.openDatabase("test", "1.0", "Test DB", 1000000);
+        }
+    
+        </script>
+      </head>
+      <body>
+        <h1>Example</h1>
+        <p>Open Database</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/guide/appdev/hooks/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/guide/appdev/hooks/index.md b/www/docs/zh-cn/5.4.0/guide/appdev/hooks/index.md
new file mode 100644
index 0000000..d25f02a
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/guide/appdev/hooks/index.md
@@ -0,0 +1,260 @@
+---
+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.
+
+title: 鉤子指南
+---
+
+# 鉤子指南
+
+科爾多瓦鉤表示特別的腳本可以由應用程式和外掛程式開發人員添加或甚至由您自己構建體系,以自訂科爾多瓦命令。 鉤腳本可以通過將其添加到特殊的預定義資料夾 (`/hooks`) 或通過設定檔 (`config.xml`和`plugin.xml`) 定義和連續運行順序如下:
+
+  * 應用程式掛鉤從`/hooks`;
+  * 應用鉤子從`config.xml`;
+  * 從`plugins/.../plugin.xml`外掛程式鉤子.
+
+**注**: `/hooks`目錄被認為是支援在 config.xml 和 plugin.xml 鉤元素,否決。
+
+## 支援的鉤類型
+
+支援以下的鉤子類型:
+
+    after_build
+    after_compile
+    after_clean
+    after_docs
+    after_emulate
+    after_platform_add
+    after_platform_rm
+    after_platform_ls
+    after_plugin_add
+    after_plugin_ls
+    after_plugin_rm
+    after_plugin_search
+    after_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only
+    after_prepare
+    after_run
+    after_serve
+    before_build
+    before_clean
+    before_compile
+    before_docs
+    before_emulate
+    before_platform_add
+    before_platform_rm/
+    before_platform_ls
+    before_plugin_add
+    before_plugin_ls
+    before_plugin_rm
+    before_plugin_search/
+    before_plugin_install // Plugin hooks in plugin.xml are executed for a plugin being installed only
+    before_plugin_uninstall // Plugin hooks in plugin.xml are executed for a plugin being uninstalled only
+    before_prepare
+    before_run
+    before_serve
+    pre_package // Windows and Windows Phone only
+    
+
+## 如何定義鉤子
+
+### 通過`/hooks`目錄
+
+**注意**: 此方法被認為是支援在 config.xml 和 plugin.xml 鉤元素,否決。
+
+在相應的鉤子類型觸發時執行自訂操作、 使用鉤型作為 '鉤' 目錄內的子資料夾的名稱和地方您編寫的指令檔在這裡,例如:
+
+    # script file will be automatically executed after each build
+    hooks/after_build/after_build_custom_action.js
+    
+
+當使用這些鉤子,他們總是將作為不作為可載入 JavaScript 模組的可執行檔運行。 **記住**: 在這種情況下使您的腳本可執行。
+
+### Config.xml
+
+鉤子可以定義在專案的`config.xml`使用`< 鉤 >`元素,例如:
+
+    <hook type="before_build" src="scripts/appBeforeBuild.bat" />
+    <hook type="before_build" src="scripts/appBeforeBuild.js" />
+    <hook type="before_plugin_install" src="scripts/appBeforePluginInstall.js" />
+    
+    <platform name="wp8">
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/wp8/appWP8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/wp8/appWP8BeforePluginInstall.js" />
+        ...
+    </platform>
+    
+    <platform name="windows8">
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.bat" />
+        <hook type="before_build" src="scripts/windows8/appWin8BeforeBuild.js" />
+        <hook type="before_plugin_install" src="scripts/windows8/appWin8BeforePluginInstall.js" />
+        ...
+    </platform>
+    
+
+### 外掛程式鉤子 (plugin.xml)
+
+作為外掛程式的開發人員,您可以定義掛接在`plugin.xml`中那樣使用`< 鉤 >`元素的腳本:
+
+    <hook type="before_plugin_install" src="scripts/beforeInstall.js" />
+    <hook type="after_build" src="scripts/afterBuild.js" />
+    
+    <platform name="wp8">
+        <hook type="before_plugin_install" src="scripts/wp8BeforeInstall.js" />
+        <hook type="before_build" src="scripts/wp8BeforeBuild.js" />
+        ...
+    </platform>
+    
+
+`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall`外掛程式鉤子將發射專門為正在安裝卸載該外掛程式。
+
+## 指令碼介面
+
+### JAVAscript
+
+如果您正在編寫鉤使用 Node.js,應使用下列模組定義:
+
+```javascript
+module.exports = function(context) {
+    ...
+}
+```
+
+您可以使用問: 你 scipts 非同步
+
+```javascript
+module.exports = function(context) {
+    var Q = context.requireCordovaModule('q');
+    var deferral = new Q.defer();
+
+    setTimeout(function(){
+      console.log('hook.js>> end');
+    deferral.resolve();
+    }, 1000);
+
+    return deferral.promise;
+}
+```
+
+`上下文`物件包含的鉤子類型,執行的腳本的完整路徑,鉤選項,命令列參數傳遞給科爾多瓦和頂級的"科爾多瓦"物件:
+
+```json
+{
+  "hook": "before_plugin_install",
+  "scriptLocation": "c:\\script\\full\\path\\appBeforePluginInstall.js",
+  "cmdLine": "The\\exact\\command\\cordova\\run\\with arguments",
+  "opts": {
+    "projectRoot":"C:\\path\\to\\the\\project",
+    "cordova": {
+      "platforms": ["wp8"],
+      "plugins": ["com.plugin.withhooks"],
+      "version": "0.21.7-dev"
+    },
+    "plugin": {
+      "id": "com.plugin.withhooks",
+      "pluginInfo": {
+        ...
+      },
+      "platform": "wp8",
+      "dir": "C:\\path\\to\\the\\project\\plugins\\com.plugin.withhooks"
+    }
+  },
+  "cordova": {...}
+}
+
+```
+
+`coNtext.opts.plugin`物件僅將傳遞到外掛程式鉤子腳本。
+
+您還可以通過以下方式使用`coNtext.requireCordovaModule`腳本中要求科爾多瓦的附加模組:
+
+```javascript
+var Q = context.requireCordovaModule('q');
+```
+
+**注意**: 新模組載入程式指令碼介面用於定義通過`config.xml`或`plugin.xml`只的`.js`檔。 出於相容性原因鉤檔指定通過`/hooks`資料夾運行通過節點 child_process 菌種,見 ' 非 javascript 一節。
+
+### 非 javascript
+
+**注意**: 我們強烈推薦寫你鉤使用 Node.js,所以,他們都是跨平臺的見上面的 'JAVAscript 一節。
+
+非 javascript 腳本從專案的根目錄中通過節點 child_process 菌種運行,並且都經過目錄根作為第一個參數。 所有其他選項都傳遞到腳本使用環境變數:
+
+  * CORDOVA_VERSION-科爾多瓦 CLI 的版本。
+  * CORDOVA_PLATFORMS-的逗號分隔清單命令適用于的平臺 (例如: android、 ios)。
+  * CORDOVA_PLUGINS-以逗號分隔的清單中的外掛程式 Id 命令適用于 (如: org.apache.cordova.file、 org.apache.cordova.file 轉讓)
+  * CORDOVA_HOOK-的掛鉤上正在執行的路徑。
+  * CORDOVA_CMDLINE-傳遞到科爾多瓦的確切的命令列參數 (例如: 科爾多瓦運行 ios — — 模仿)
+
+如果一個腳本返回一個非零結束代碼,然後將中止父科爾多瓦命令。
+
+此外請注意,即使您正在在 Windows 上,以防你鉤腳本並不是蝙蝠檔 (這建議,如果你想要你上班非 Windows 作業系統中的腳本) 科爾多瓦 CLI 將期望一切線作為第一行才知道翻譯它需要使用啟動腳本。 一切行應匹配下面的示例:
+
+    #!/usr/bin/env [name_of_interpreter_executable]
+    
+
+## 示例用法
+
+此示例演示科爾多瓦鉤用法跟蹤到主控台輸出為 Android 平臺生成的.apk 檔的大小。
+
+創建空白科爾多瓦 app 並向`config.xml`來告訴科爾多瓦在每個平臺生成後運行`afterBuild.js`腳本添加下面的定義。
+
+    <hook type="after_build" src="scripts/afterBuild.js" />
+    
+
+創建`scripts/afterBuild.js`檔並添加下面的實現。 我們使用`fs.stat`方法的非同步版本來演示如何非同步功能可以通過掛鉤。
+
+    module.exports = function(ctx) {
+        // make sure android platform is part of build 
+        if (ctx.opts.platforms.indexOf('android') < 0) {
+            return;
+        }
+        var fs = ctx.requireCordovaModule('fs'),
+            path = ctx.requireCordovaModule('path'),
+            deferral = ctx.requireCordovaModule('q').defer();
+    
+        var platformRoot = path.join(ctx.opts.projectRoot, 'platforms/android');
+        var apkFileLocation = path.join(platformRoot, 'build/outputs/apk/android-debug.apk');
+    
+        fs.stat(apkFileLocation, function(err,stats) {
+            if (err) {
+                 deferral.reject('Operation failed');
+            } else {
+                console.log('Size of ' + apkFileLocation + ' is ' + stats.size +' bytes');
+                deferral.resolve();
+            }
+        });
+    
+        return deferral.promise;
+    };
+    
+
+參數`環磷醯胺`在上面例子中通過科爾多瓦和表示腳本的完整路徑、 目標平臺、 命令列參數等的執行上下文,也暴露出額外的協助工具。 有關更多詳細資訊請參見`指令碼介面`節以上。
+
+現在可以添加 android 平臺,並執行生成。
+
+    cordova platform add android
+    ..
+    cordova build
+    ..
+    Size of path\to\app\platforms\android\build\outputs\apk\android-debug.apk is 1821193 bytes
+    
+
+可以在這裡找到更多好的用法示例:
+
+<http://devgirl.org/2013/11/12/three-hooks-your-cordovaphonegap-project-needs/>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/guide/appdev/privacy/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/guide/appdev/privacy/index.md b/www/docs/zh-cn/5.4.0/guide/appdev/privacy/index.md
new file mode 100644
index 0000000..a52f277
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/guide/appdev/privacy/index.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.
+
+title: 隱私指南
+---
+
+# 隱私指南
+
+手機隱私是每個應用程式開發者必須解決的關鍵問題。 您的使用者期望將搜集他們的私人資訊,並由您的應用程式得到適當的處理。此外,有越來越多的現在有關于手機隱私慣例的法律要求司法管轄區。
+
+本指南中的移動應用程式的隱私應被視為一*底漆*處理一些最重要的問題。 它概述了人們廣泛接受的一些最佳做法,並提供到其他更詳細的指南和參考參考。
+
+*   **私隱政策**: 您的應用程式應包括私隱政策,解決什麼樣的資訊應用程式收集來自或關於您的使用者、 如何使用這些資訊,與誰它共用的和如何使用者可以在應用程式內私隱有關的選擇等主題。以説明理解,你應該使用普通語言和避免技術術語。 你應該使您的隱私權原則可供使用者之前下載,如審查的 app 描述中的應用市場。 此外,應使您的隱私權原則可用在該應用程式本身的範圍內。 有限的行動裝置的顯示大小創建用於向使用者顯示私隱政策的挑戰。 考慮發展一種*縮寫形式*的政策,其中包括最重要的資訊,,然後在更多的細節感興趣的人提供一個連結到"長表"政策。 幾個小組正試圖開發基於圖示通信隱私慣例,你可能想要考慮一旦這些標準成熟的標準。
+
+*   **敏感資訊的收集**: 敏感的個人資訊的應用程式的集合將引發重要隱私問題。 敏感的個人資訊的例子包括敏感的財務資訊,健康的資訊,並從或兒童的資訊。 它還包括從某些感應器和通常發現行動裝置和平板電腦、 地理定位資訊、 連絡人/電話簿、 麥克風/相機和存儲的圖片視頻等的資料庫收集的資訊。 請參見以下文檔頁的詳細資訊:[相機][1]、[捕獲][2]、[連絡人][3]和[地理定位][4]。 一般情況下,您應該獲得使用者的明確許可之前收集敏感資訊,如果可能的話,提供一種控制機制,使使用者可以輕鬆地更改許可權。 應用程式的作業系統可以説明在某些情況下提出只是時間的對話方塊,要求使用者的許可權前集合。 在這些情況下,一定要利用任何機會,若要自訂對話方塊的框文本,以澄清如何應用程式使用,並且,如果適用,將共用此類資
 訊。
+
+*   **避免使用者驚喜**: 如果應用程式收集或使用中可能向使用者根據您的應用程式 (例如,訪問存儲的圖片的音樂播放機) 的主要目的令人驚訝的方式的資訊,你應該帶類似的步驟作為敏感個人資訊的收集。 這就是,你強烈應考慮只是時間對話方塊通知使用者有關集合或該資訊的使用,並提供一個相應的隱私控制項,如果合適的話,的使用。
+
+*   **協力廠商資料收集或分享**: 如果你的應用程式收集到另一家公司 — — 提供的資訊,如一個社交網路平臺或廣告網路 (例如,如果您的應用程式會顯示廣告) — — 你應該告知該集合的使用者和共用。 至少,您的隱私權原則應該描述資訊收集和共用和,如果合適的話,為您的使用者提供控制能力或退出這種集合或共用。
+
+*   **集合限制和安全**: 您的使用者委託他們的資訊與您的應用程式,他們期望你將會採取適當的安全防範措施來保護它。 避免個人資訊的安全妥協的最佳方法之一併不是在第一次的地方收集的資訊,除非您的應用程式具有集合的一個具體和合法的商業原因。 不會需要收集的資訊,確保你提供適當的安全控制,以保護該資訊,無論它存儲在設備上或在您的後端伺服器上。 您還應開發這款應用和後端伺服器上實施適當的資料保留原則。
+
+ [1]: cordova_camera_camera.md.html
+ [2]: cordova_media_capture_capture.md.html
+ [3]: cordova_contacts_contacts.md.html
+ [4]: cordova_geolocation_geolocation.md.html
+
+以下是一些其他有用手機隱私指南,開發人員:
+
+*   加州總檢察長[私隱去: 移動生態系統的建議][5]
+
+*   民主與技術,隱私論壇,[為手機應用程式開發人員的最佳做法][6]的未來中心
+
+*   CTIA 無線協會、[最佳做法和準則的位置基於服務][7]
+
+*   聯邦貿易委員會,[手機隱私披露: 建立信任通過透明度][8]
+
+*   [應用隱私][9]網站隱私論壇的未來
+
+ [5]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf
+ [6]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf
+ [7]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300
+ [8]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf
+ [9]: http://www.applicationprivacy.org
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/guide/appdev/security/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/guide/appdev/security/index.md b/www/docs/zh-cn/5.4.0/guide/appdev/security/index.md
new file mode 100644
index 0000000..6b7d693
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/guide/appdev/security/index.md
@@ -0,0 +1,108 @@
+---
+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.
+
+title: 安全指南
+---
+
+# 安全指南
+
+以下指南包括開發科爾多瓦的應用程式時,應考慮一些安全最佳做法。 請務必注意安全是一個非常複雜的主題,因此本指南不是詳盡無遺。 如果你認為你可以貢獻本指南,請隨時在科爾多瓦的 bug 追蹤器下["文檔"][1]中檔的問題。 本指南旨在適用于一般科爾多瓦發展 (所有平臺),但將指出特定于平臺的特殊注意事項。
+
+ [1]: https://issues.apache.org/jira/browse/CB/component/12316407
+
+## 本指南討論了下列主題:
+
+*   白名單
+*   Iframe 和回檔 Id 機制
+*   證書寄
+*   自簽名的證書
+*   加密的存儲
+*   一般提示
+*   推薦的文章和其他資源
+
+## 白名單
+
+*   閱讀和理解,白名單指南
+
+*   域白名單不能在 Android API 10 及以下,WP8 iframe 和用戶端代碼。 這意味著攻擊者可以載入任何域中的 iframe,在 iframe 內頁面上的任何腳本可以直接存取科爾多瓦 JavaScript 物件和相應的本機 JAVA 物件。 當為這些平臺構建應用程式時,應考慮到這種情況。 在實踐中這意味著確保目標高於 10,Android API 和如果可能的話您不使用 iframe 載入外部內容-使用 inAppBrowser 外掛程式或其他協力廠商外掛程式。
+
+## Iframe 和回檔 Id 機制
+
+如果內容提供在 iframe 從白名單中的域中,該域將可以訪問到本機的科爾多瓦橋。 這意味著,如果白名單中的協力廠商廣告網路和服務通過 iframe 的那些廣告,它有可能是惡意的廣告將能夠打破 iframe 並執行惡意操作。 因此,您通常不應使用 iframe 除非你控制的伺服器的承載的 iframe 內容。 此外請注意有協力廠商外掛程式提供支援的廣告網路。 注意此語句不是真正的 iOS,攔截一切包括 iframe 的連接。
+
+## 證書寄
+
+科爾多瓦不支援真正的證書固定。 對此的一個主要障礙是證書的缺乏在 android 系統中的本機 Api 攔截 SSL 連線執行檢查伺服器。 (雖然有可能要做證書寄于 Android 在 JAVA 中使用 JSSE,c + +,編寫在 android 系統上的 web 視圖和 web 視圖為你處理伺服器連接,所以它是不可能有使用 JAVA 和 JSSE)。因為 Apache 科爾多瓦要跨多個平臺提供一致的 Api,不具有能力的一個主要平臺打破了這種一致性。
+
+有種方法近似證書鎖定,如檢查伺服器的公開金鑰 (指紋) 預期值,當您的應用程式啟動時或在其他不同的時間,在您的應用程式的存留期內。 有協力廠商外掛程式可供能不能做到的科爾多瓦。 然而,這不是真實證書將鎖定,將自動驗證每個連接到伺服器上的預期值相同。
+
+## 自簽名的證書
+
+不建議在您的伺服器上使用自簽名的證書。 如果你渴望 SSL,那麼強烈建議您的伺服器具有已正確地簽署了著名的 CA (憑證授權單位) 的證書。 不能做真正的證書寄使這一重要。
+
+原因是接受自簽名的證書繞過憑證連結驗證,它允許任何伺服器憑證才被視為有效的設備。 這將打開溝通的人在中間的攻擊。 它變得非常容易為駭客不僅攔截並讀取在設備和伺服器之間的所有通信,但也要修改通信。 設備永遠不會知道這種情況發生,因為它不會驗證服務器的證書由受信任的 CA 簽署。 該設備具有伺服器是它期望的人沒有證據證明。 因為做的人在中間攻擊的易用性,接受自簽名的證書才略微比只在不受信任的網路上運行而不是 HTTPs 的 HTTP。 是的交通將會被加密,但它可能會用金鑰加密從一個男人-中--中間,所以攔截中可以訪問的一切,所以加密是無用除了對被動的觀察員。 使用者信任 SSL 以是安全的和這將故意做出它不安全的所以,SSL 利用成為具誤導性。 如果這將受信任的網路上使用 (即,您是完全控制企業內部),然後仍
 不建議使用自簽名的證書。 在受信任的網路中的兩項建議是因為網路本身是受信任的只是使用 HTTP 或獲取由受信任的 CA (不自簽名) 簽署的證書。 網路是受信任的或者它不是。
+
+在這裡所描述的原則不是特定于 Apache 科爾多瓦,它們適用于所有用戶端-伺服器通信。
+
+當運行時科爾多瓦在 android 系統上,使用 `android:debuggable="true"` 應用程式中清單將允許 SSL 錯誤,例如憑證連結驗證錯誤的自簽章憑證。 所以您可以在此配置中,使用自簽名的證書,但這不是一種配置,您的應用程式是在生產時,應使用。 意思是,只有在應用程式開發期間使用。
+
+## 加密的存儲
+
+(TBD)
+
+## 一般提示
+
+### 不要使用 Android 姜餅 !
+
+*   設置您的 min-目標-sdk 級別高於 10。API 10 是姜餅,和姜餅由谷歌或設備製造商,不再受支援,因此不推薦由科爾多瓦隊。 
+*   姜餅已被證明是不安全和最大的一個有針對性的移動開放源碼軟體[HTTP://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/][2]. 
+*   在 Android 上的白名單不工作與姜餅或更低。 這意味著攻擊者可以載入,然後會對所有的科爾多瓦 Api 的訪問,可以使用該存取權限來竊取個人資料、 發送 SMS 消息到溢價率的數位,以及執行其他惡意行為的 iframe 中的惡意程式碼。 
+
+ [2]: http://bgr.com/2012/11/06/android-security-gingerbread-malware/
+
+### 使用 InAppBrowser 的外部連結
+
+*   打開任何外部網站的連結時,請使用 InAppBrowser。 這是比白一個功能變數名稱和直接在您的應用程式中包括的內容,因為 InAppBrowser 將使用本機瀏覽器的安全功能,並不會給網站訪問到您的科爾多瓦環境安全得多。 即使您信任的協力廠商網站,並將其包括在您的應用程式中直接,那協力廠商網站可能連結到惡意 web 內容。 
+
+### 驗證所有使用者輸入
+
+*   始終驗證您的應用程式接受的任何和所有輸入。 這包括使用者名、 密碼、 日期、 上載的媒體等。 因為攻擊者可以操縱您的 HTML 和 JS 資產 (無論是通過反編譯您的應用程式或使用像 chrome://inspect 這樣的調試工具),這應該也執行驗證您在伺服器上,尤其是在將資料提交給任何後端服務之前。 
+*   其他來來源資料應進行的驗證: 使用者文檔、 連絡人、 推式通知
+
+### 不緩存敏感性資料
+
+*   如果使用者名、 密碼、 地理定位資訊和其他敏感性資料被緩存,然後它可以潛在檢索以後由未經授權的使用者或應用程式。
+
+### 除非你知道你在做什麼,否則不要使用 eval()
+
+*   JavaScript 函數 eval() 有被虐待的歷史悠久。不正確地使用它,可以打開您的代碼注入攻擊,調試困難和代碼執行速度變慢了。 
+
+### 不要假定您的原始程式碼是安全的
+
+*   因為從 HTML 和 JavaScript 的資產在本機容器中獲取打包生成的科爾多瓦應用程式,不應考慮您的代碼是安全的。 它是可能要進行反向工程科爾多瓦應用程式。 
+
+## 推薦的文章和其他資源
+
+*   [HTML5 安全作弊,詳細說明了如何確保您的 HTML5 應用程式][3]
+*   [Phonegap 條設備安全問題,例如,使用加密的資料][4]
+*   [關於 web 視圖中的眾所周知的安全缺陷白皮書基於混合應用程式][5]
+
+ [3]: https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet
+ [4]: https://github.com/phonegap/phonegap/wiki/Platform-Security
+ [5]: http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/guide/appdev/whitelist/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/guide/appdev/whitelist/index.md b/www/docs/zh-cn/5.4.0/guide/appdev/whitelist/index.md
new file mode 100644
index 0000000..271e61b
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/guide/appdev/whitelist/index.md
@@ -0,0 +1,145 @@
+---
+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.
+
+title: 白名單指南
+---
+
+# 白名單指南
+
+域白名單是一種控制訪問的安全模型向外部域,您的應用程式已不能控制。 科爾多瓦提供了一個可配置的安全性原則來定義可以訪問外部網站。 預設情況下,新的應用程式被配置為允許訪問任何網站。 在您的應用程式到生產之前,應制訂白名單和允許訪問特定的網路域和子域。
+
+對於 Android 和 iOS (如其 4.0 的版本),科爾多瓦的安全性原則是可擴展的通過一個外掛程式介面。 您的應用程式應使用 [cordova-plugin-whitelist][1],因為它提供了更好的安全性和可配置性比早期版本的科爾多瓦。 雖然有可能實現自己的白名單外掛程式,它不建議除非您的應用程式有非常具體的安全性原則要求。 有關用法和配置,請參閱 [cordova-plugin-whitelist][1] 的詳細資訊。
+
+ [1]: https://github.com/apache/cordova-plugin-whitelist
+
+對於其他平臺,科爾多瓦遵循 [W3C 部件訪問][2] 規範,這依賴于應用程式的 `config.xml` 檔以啟用對特定域的網路訪問中的 `<access>` 元素。 對於依賴于描述在命令列介面的 CLI 工作流程的專案,此檔位於專案的頂級目錄。 否則對於特定于平臺的發展路徑,以下各節列出的位置。 (每個平臺上見各種平臺指南的詳細資訊)。
+
+ [2]: http://www.w3.org/TR/widgets-access/
+
+下面的示例演示 `<access>` 白名單語法:
+
+*   [Google.com][3]訪問:
+    
+        <access origin="http://google.com" />
+        
+
+*   對安全[google.com][4]的訪問 ( `https://` ):
+    
+        <access origin="https://google.com" />
+        
+
+*   子域[maps.google.com][5]訪問:
+    
+        <access origin="http://maps.google.com" />
+        
+
+*   對所有子域[google.com][3],例如[mail.google.com][6]和[docs.google.com][7]的訪問:
+    
+        <access origin="http://*.google.com" />
+        
+
+*   到*所有*的域,例如, [google.com][3]和[developer.mozilla.org][8]的訪問:
+    
+        <access origin="*" />
+        
+    
+    這是新創建的 CLI 專案的預設值。
+
+ [3]: http://google.com
+ [4]: https://google.com
+ [5]: http://maps.google.com
+ [6]: http://mail.google.com
+ [7]: http://docs.google.com
+ [8]: http://developer.mozilla.org
+
+要知道有些網站可以自動從其主頁定向到不同的 url,例如,使用 HTTPs 協定或具體國家域。 例如 HTTP://www.google.com 將重定向在 HTTPs://www.google.com,使用 SSL/TLS,然後可能進一步將重定向到一個地理位置,例如 HTTPs://www.google.co.uk。 這樣的場景可能需要修改或額外的白名單的作品可以超越你所需的初期。 請考慮這您構建您的白名單。
+
+請注意白名單僅適用于主要的科爾多瓦 web 視圖,不適用於 InAppBrowser web 視圖或系統 web 瀏覽器中的打開連結。
+
+## 亞馬遜火 OS 白
+
+在 `res/xml/config.xml` 中找到特定于平臺的白名單規則.
+
+## Android 白
+
+如上所述,看到 [cordova-plugin-whitelist][1] 的詳細資訊。科爾多瓦 android 4.0.0 之前,請參閱本文檔的舊版本。
+
+## iOS 白名單
+
+如上所述,看到 [cordova-plugin-whitelist][1] 的詳細資訊。科爾多瓦 ios 4.0.0 之前,請參閱本文檔的舊版本。
+
+## 黑莓 10 白名單
+
+在 `www/config.xml` 中找到白名單規則.
+
+黑莓 10年使用萬用字元有別于其他平臺兩種方式:
+
+*   必須顯式聲明由 `XMLHttpRequest` 訪問的任何內容。 設置 `origin="*"` 不能在這種情況下。 或者,可能使用黑莓手機配置中所述的 `WebSecurity` 偏好禁用所有 web 安全性:
+    
+        <preference name="websecurity" value="disable" />
+        
+
+*   作為設置 `*.domain` 的替代方法,將其他 `subdomains` 屬性設置為 `true`。 它應該被預設設置為 `false`。 例如,下面的允許訪問 `google.com`,`maps.google.com` 和 `docs.google.com`:
+    
+        <access origin="http://google.com" subdomains="true" />
+        
+    
+    `Google.com` 以下縮小存取權限:
+    
+        <access origin="http://google.com" subdomains="false" />
+        
+    
+    指定訪問到所有的域,包括本地 `file://` 協定:
+    
+        <access origin="*" subdomains="true" />
+        
+
+(有關支援的詳細資訊,請參閱黑莓的文檔 [訪問元素][9] 上.)
+
+ [9]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html
+
+## 火狐瀏覽器作業系統
+
+火狐瀏覽器作業系統特定的域還有白名單沒有概念。 相反,有特殊的許可權稱為 [SystemXHR][10]。 有必要將此許可權添加到 `config.xml`:
+
+ [10]: https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#Permissions
+
+    <platform name="firefoxos">
+        <permission name="systemXHR" privileged="true" description="load data from server" />
+    </platform>
+    
+
+`XMLHttpRequest` 物件需要使用兩個參數 `mozAnon` 和 `mozSystem` 進行具現化:
+
+    var request = new XMLHttpRequest({
+        mozAnon: true,
+        mozSystem: true});
+    
+
+此解決方案是透明的因此沒有其他平臺的區別。
+
+## Windows Phone 白名單
+
+Windows Phone 8 的白名單規則是在應用程式的 `config.xml` 檔中找到的。
+
+## 泰白名單
+
+白名單規則是在應用程式的 `config.xml` 檔中找到的。 平臺依靠相同的 `subdomains` 屬性作為黑莓平臺。 (有關支援的詳細資訊,請參閱 Tizen 的文檔 [訪問元素][11] 上.)
+
+ [11]: https://developer.tizen.org/help/index.jsp?topic=%2Forg.tizen.web.appprogramming%2Fhtml%2Fide_sdk_tools%2Fconfig_editor_w3celements.htm
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/5.4.0/guide/cli/index.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/5.4.0/guide/cli/index.md b/www/docs/zh-cn/5.4.0/guide/cli/index.md
new file mode 100644
index 0000000..d702c3e
--- /dev/null
+++ b/www/docs/zh-cn/5.4.0/guide/cli/index.md
@@ -0,0 +1,418 @@
+---
+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.
+
+title: 命令列介面
+---
+
+# 命令列介面
+
+本指南演示如何創建應用程式並將它們部署到各種本機移動平臺,使用 `cordova` 命令列介面 (CLI)。 此工具允許您創建新的專案、 生成它們在不同平臺上,並運行實際設備或模擬程式內。 CLI 是要使用的跨平臺工作流概述中所述的主要工具。 否則還可以使用 CLI 來初始化專案代碼,然後切換到各種平臺 Sdk 和外殼工具為繼續發展。
+
+## 系統必備元件
+
+在運行任何命令列工具之前, 您需要為每個您想要的目標的平臺安裝 Sdk。(參見平臺指南更多詳細資訊。
+
+若要添加支援或重建任何平臺的一個專案,您需要從支援的平臺 SDK 的同一台電腦上運行命令列介面。CLI 支援以下組合:
+
+*   iOS (Mac)
+*   亞馬遜火 OS (Mac、 Linux、 Windows)
+*   Android (Mac、 Linux、 Windows)
+*   黑莓 10 (Mac、 Linux、 Windows)
+*   Windows Phone 8 (Windows)
+*   視窗 (視窗)
+*   火狐瀏覽器的作業系統 (Mac、 Linux、 Windows)
+
+在 Mac 上,命令列是可通過*終端*應用的。在 PC 上,它是可作為*命令提示符*下*配件*.
+
+**注**: 僅限 Windows 平臺,你還可以您在 Mac 的硬體上的發展通過在虛擬機器環境中或在雙啟動模式下運行 Windows。 可用的選項,請參閱 Windows Phone 8 平臺指南或 Windows 平臺指南。
+
+就越有可能是你在 CLI 運行從不同的機器,更有意義保持遠端原始程式碼儲存庫,你拉下到本地工作目錄的資產。
+
+## 安裝科爾多瓦 CLI
+
+作為故宮包中使用準備好的格式分發,科爾多瓦命令列工具。不是有必要從原始程式碼中編譯它。
+
+若要安裝 `cordova` 命令列工具,請按照這些步驟操作:
+
+1.  下載並安裝[Node.js][1]。 安裝完成後,您應該能夠調用 `node` 和 `npm` 在命令列上。 如果需要,您可能會選擇使用工具如 `nvm` 或 `nave` 來管理您的 Node.js 安裝。
+
+2.  下載並安裝一個[git 用戶端][2],如果你已經沒有之一。 安裝完成後,您應該能夠調用 `git` 對您的命令列。 即使您不會使用 `git` 手動,CLI 不會使用它幕後下載一些資產時創建一個新專案。
+
+3.  安裝 `cordova` 模組使用 `npm` 實用程式的 Node.js。`cordova`模組將會自動下載的 `npm` 實用程式。
+
+ [1]: http://nodejs.org/
+ [2]: http://git-scm.com/
+
+*   在 OS X 與 Linux:
+    
+            $ sudo npm install -g cordova
+        
+    
+    在 OS X 與 Linux,首碼 `npm` 命令與 `sudo` 可能需要安裝這種發展中的實用程式否則限制目錄如 `/usr/local/share` 。 如果您使用的可選的 nvm/教堂中殿工具或具有對安裝目錄的寫存取權限,您可能能夠省略 `sudo` 首碼。 有[的更多提示][3]可用上使用 `npm` 無 `sudo` 、 如果你渴望做的。
+
+*   關於視窗:
+    
+            C:\>npm install -g cordova
+        
+    
+    `-g`國旗上面告訴 `npm` 要安裝 `cordova` 全球。 否則它將被安裝在 `node_modules` 的當前工作目錄的子目錄。
+    
+    您可能需要添加 `npm` 目錄到您 `PATH` 調用全域安裝 `npm` 模組。 在 Windows 中, `npm` 通常可以發現在 `C:\Users\username\AppData\Roaming\npm` 。 在 OS X 與 Linux 上它通常可以找到在`/usr/local/share/npm`.
+    
+    安裝日誌可能會產生錯誤的任何已卸載平臺 Sdk。
+    
+    安裝完成後,您應該能夠運行 `cordova` 與沒有參數和它在命令列上應列印説明文本。
+
+ [3]: http://justjs.com/posts/npm-link-developing-your-own-npm-modules-without-tears
+
+## 創建應用程式
+
+轉至目錄位置您維護您的原始程式碼,並運行以下命令:
+
+        $ cordova create hello com.example.hello HelloWorld
+    
+
+它可能需要一些時間完成的命令,有耐心。運行該命令與 `-d` 選項將顯示有關其進度的資訊。
+
+*你好*第一個參數指定要為您的專案生成的目錄。 此目錄不應該存在,科爾多瓦將為您創建它。 其 `www` 子目錄的房子您應用程式的主頁上,與各種資源下 `css` , `js` ,和 `img` ,其中遵循共同 web 發展的檔命名約定。 這些資產將會存儲在設備的本地檔案系統,不提供遠端。 `config.xml`檔包含生成和分發應用程式所需的重要的中繼資料。
+
+第二個參數 `com.example.hello` 為您的專案提供了一個反向域樣式識別碼。 此參數是可選的但只有當你也省略第三個參數,因為參數是位置。 您可以編輯以後此值在 `config.xml` 檔中,但一定要注意可能生成外部的代碼 `config.xml` 使用此值,如 JAVA 套裝軟體名稱。 預設值是 `io.cordova.hellocordova` ,但它建議你選擇一個適當的值。
+
+第三個參數 `HelloWorld` 提供了應用程式的顯示標題。 此參數是可選的。 您可以編輯以後此值在 `config.xml` 檔中,但一定要注意可能生成外部的代碼 `config.xml` 使用此值,如 JAVA 類的名稱。 預設值是 `HelloCordova` ,但它建議你選擇一個適當的值。
+
+## 添加平臺
+
+後面的所有命令都需要在專案的目錄或在其範圍內的任何子目錄內運行:
+
+        $ cd hello
+    
+
+您可以生成專案之前,您需要指定一組的目標平臺。 您運行這些命令的能力取決於您的電腦是否支援每個 SDK,是否你已經安裝每個 SDK。 運行任何這些從 Mac:
+
+        $ cordova platform add ios
+        $ cordova platform add amazon-fireos
+        $ cordova platform add android
+        $ cordova platform add blackberry10
+        $ cordova platform add firefoxos
+    
+
+運行的這些 Windows 機器上,從任何地方*wp*指的是不同版本的 Windows Phone 作業系統:
+
+        $ 科爾多瓦平臺添加 wp8 $ 科爾多瓦平臺添加的 windows $ 科爾多瓦平臺添加亞馬遜 fireos $ 科爾多瓦平臺添加 android $ 科爾多瓦平臺添加 blackberry10 $ 科爾多瓦平臺添加 firefoxos
+    
+
+運行此檢查當前設置的平臺:
+
+        $ cordova platforms ls
+    
+
+(請注意 `platform` 和 `platforms` 命令是同義語.)
+
+請運行下列同義命令來刪除一個平臺之一:
+
+        $ cordova platform remove blackberry10
+        $ cordova platform rm amazon-fireos
+        $ cordova platform rm android
+    
+
+運行命令來添加或刪除平臺影響專案的*平臺*目錄的內容每個指定的平臺作為一個子目錄中的顯示位置。 *Www*原始目錄轉載內每個平臺的子目錄中,例如出現在 `platforms/ios/www` 或 `platforms/android/assets/www` 。 因為 CLI 不斷複製在源*www*資料夾中的檔,應只編輯這些檔,並不是位於*平臺*的子目錄下。 如果您使用的版本控制軟體,您應將此源*www*資料夾,該*合併*的資料夾,添加到您的版本控制系統。 (有關*合併*資料夾的詳細資訊可以找到下面的自訂每個平臺部分中)
+
+**警告**: 當使用 CLI 來構建您的應用程式,你應該*不是*編輯任何檔在 `/platforms/` 目錄,除非你知道你在做什麼,或者如果檔指定,否則。 準備申請建設,或重新安裝外掛程式時經常將覆蓋此目錄中的檔。
+
+如果您希望在此時,你可以使用 Eclipse 或 Xcode SDK 打開你創建的專案。 您將需要打開的資產從衍生金融工具集 `/platforms/` 要用 SDK 開發目錄。 這是因為 SDK 的特定元資料檔案存儲在相應的 `/platform/` 子目錄。 (見如何開發應用程式每個 IDE 內的資訊平臺指南)使用這種方法,如果你只是想要初始化使用 CLI 的專案,然後切換到 SDK 為本機的工作。
+
+如果您想要使用的整個開發週期的跨平臺的工作流方式 (CLI),請繼續閱讀。
+
+## 構建應用程式
+
+預設情況下, `cordova create` 腳本生成骨骼基於 web 應用程式的主頁是該專案的 `www/index.html` 檔。 編輯此應用程式,但是你想要但應作為的一部分指定的任何初始化 `[deviceready](../../cordova/events/events.deviceready.html)` 事件處理常式中,從預設的引用`www/js/index.js`.
+
+運行以下命令以反覆運算方式生成專案:
+
+        $ cordova build
+    
+
+這將生成特定于平臺代碼內專案的 `platforms` 子目錄。你可以選擇限制到特定的平臺每個生成的範圍:
+
+        $ cordova build ios
+    
+
+`cordova build`命令是以下,而在此示例中還針對的是一個單一的平臺的簡寫形式:
+
+        $ cordova prepare ios
+        $ cordova compile ios
+    
+
+在這種情況下,一次您運行 `prepare` ,你可以作為備用使用蘋果公司的 Xcode SDK 修改和編譯科爾多瓦在範圍內生成的特定于平臺代碼 `platforms/ios` 。 您可以使用相同的方法與其他平臺的 Sdk。
+
+## 測試模擬器或設備上的應用程式
+
+移動平臺 Sdk 經常與捆綁在一起執行設備的圖像,以便您可以啟動該應用程式從主畫面並看看它如何與許多平臺功能交互的模擬程式。 運行如下命令來重新生成應用程式並查看它在特定的平臺模擬器內:
+
+        $ cordova emulate android
+    
+
+一些移動平臺類比特定設備預設情況下,iPhone 的 iOS 專案等。對於其他平臺,您可能需要首先將設備模擬程式與相關聯。
+
+**注**: 模擬器支援目前不可用的亞馬遜火 OS。
+
+(見平臺指南的詳細資訊)。例如,您可能會首先運行 `android` 命令以啟動 Android SDK,然後運行一個特定的設備圖像,啟動它根據其預設行為:
+
+![][4]
+
+ [4]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_init.png
+
+跟進與 `cordova emulate` 命令刷新顯示的最新應用,現已從主畫面發射的模擬程式圖像:
+
+![][5]
+
+ [5]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_install.png
+
+或者,可以將手機插入您的電腦和直接測試應用程式:
+
+        $ cordova run android
+    
+
+在運行此命令之前, 您需要設置的設備進行測試,之後會發生變化,為每個平臺的程式。 在 Android 和亞馬遜火 OS 設備,你將必須啟用設備上的**USB 調試**的選項和或許添加 USB 驅動程式根據您發展導讀工作。 每個平臺的要求的詳細資訊,請參閱平臺指南。
+
+## 添加外掛程式的功能
+
+生成和查看一個新專案時,將顯示預設的應用程式不會很多。 您可以修改該應用程式在許多方面,利用標準的 web 技術,但應用程式緊密的聯繫,與各種設備級功能,您需要添加外掛程式,提供對核心科爾多瓦 Api 的訪問。
+
+*外掛程式*是有點的載入項代碼的提供的本機組件的介面。 您可以設計您自己的外掛程式介面,例如,設計一個混合應用程式,與本機組件混合科爾多瓦 web 視圖時。 (請參閱嵌入 WebViews 和[外掛程式開發指南][6]的詳細資訊。更常見的是,您將添加外掛程式,以便啟用科爾多瓦的基本設備級功能詳細的 API Reference 中之一。
+
+ [6]: guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide
+
+版本 3.0,當您創建一個專案,科爾多瓦它並沒有存在任何外掛程式。這是新的缺省行為。你的願望,甚至核心外掛程式,必須顯式添加任何外掛程式。
+
+這些外掛程式,包括由社會,提供額外的協力廠商外掛程式的清單可以在[plugins.cordova.io][7]在註冊表中找到。 您可以使用 CLI 要搜索的從這個註冊表外掛程式。 例如,搜索 `bar` 和 `code` 產生單個結果相匹配這兩個術語作為子字串不區分大小寫:
+
+ [7]: http://plugins.cordova.io/
+
+        $ cordova plugin search bar code
+    
+        com.phonegap.plugins.barcodescanner - Scans Barcodes
+    
+
+只有在尋找 `bar` 長期收益率和額外的結果:
+
+        cordova-plugin-statusbar - Cordova StatusBar Plugin
+    
+
+`cordova plugin add`命令需要您指定的外掛程式代碼的存儲庫。這裡是你如何使用 CLI 來向應用程式添加功能的示例:
+
+*   基本設備資訊 (設備 API):
+    
+        $ cordova plugin add cordova-plugin-device
+        
+
+*   網路連接和電池事件:
+    
+        $ cordova plugin add cordova-plugin-network-information
+        $ cordova plugin add cordova-plugin-battery-status
+        
+
+*   加速度計、 指南針、 和地理定位:
+    
+        $ cordova plugin add cordova-plugin-device-motion
+        $ cordova plugin add cordova-plugin-device-orientation
+        $ cordova plugin add cordova-plugin-geolocation
+        
+
+*   相機、 媒體重播和捕獲:
+    
+        $ cordova plugin add cordova-plugin-camera
+        $ cordova plugin add cordova-plugin-media-capture
+        $ cordova plugin add cordova-plugin-media
+        
+
+*   訪問設備或網路 (檔 API) 上的檔:
+    
+        $ cordova plugin add cordova-plugin-file
+        $ cordova plugin add cordova-plugin-file-transfer
+        
+
+*   通過對話方塊或振動發出通知:
+    
+        $ cordova plugin add cordova-plugin-dialogs
+        $ cordova plugin add cordova-plugin-vibration
+        
+
+*   連絡人:
+    
+        $ cordova plugin add cordova-plugin-contacts
+        
+
+*   全球化:
+    
+        $ cordova plugin add cordova-plugin-globalization
+        
+
+*   閃屏:
+    
+        $ cordova plugin add cordova-plugin-splashscreen
+        
+
+*   打開新的瀏覽器視窗 (InAppBrowser):
+    
+        $ cordova plugin add cordova-plugin-inappbrowser
+        
+
+*   調試主控台:
+    
+        $ cordova plugin add cordova-plugin-console
+        
+
+**注意**: CLI 將作為每個平臺的相應添加外掛程式代碼。 如果你想要發展與低級別外殼工具或平臺 Sdk 作為概述中討論,你需要運行 Plugman 實用程式來添加外掛程式單獨為每個平臺。 (有關詳細資訊,見使用 Plugman 管理外掛程式)。
+
+使用 `plugin ls` (或 `plugin list` ,或 `plugin` 本身) 查看當前已安裝的外掛程式。每個顯示的識別碼:
+
+        $ cordova plugin ls    # or 'plugin list'
+        [ 'cordova-plugin-console' ]
+    
+
+若要刪除一個外掛程式,它通過引用相同的識別碼出現在清單中。例如,在這裡是如何你會從一個發佈版本中刪除調試主控台的支援:
+
+        $ cordova plugin rm cordova-plugin-console
+        $ cordova plugin remove cordova-plugin-console    # same
+    
+
+你可以大量刪除或添加的外掛程式通過指定多個參數的每個命令:
+
+        $ cordova plugin add cordova-plugin-console cordova-plugin-device
+    
+
+## 高級的外掛程式選項
+
+當添加外掛程式,幾個選項允許您指定從何處獲取該外掛程式。 上面的例子使用知名 `registry.cordova.io` 註冊表和該外掛程式由指定 `id` :
+
+        $ cordova plugin add cordova-plugin-console
+    
+
+`id`還可能包括外掛程式的版本號碼後, 追加 `@` 字元。`latest`版本是最新版本的一個別名。例如:
+
+        $ cordova plugin add cordova-plugin-console@latest
+        $ cordova plugin add cordova-plugin-console@0.2.1
+    
+
+如果在沒有註冊該外掛程式 `registry.cordova.io` 位於另一個 git 倉庫,但您可以指定一個備用的 URL:
+
+        $ cordova plugin add https://github.com/apache/cordova-plugin-console.git
+    
+
+上面的 git 示例從主分支,末尾讀取外掛程式但備用的 git ref,如一個標記或分支可以追加後 `#` 字元:
+
+從標記安裝:
+
+        $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
+    
+
+或一個分支:
+
+        $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#CB-8438cordova-plugin-console
+    
+
+或 git ref 也可能是一個特定的提交:
+
+        $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#f055daec45575bf08538f885e09c85a0eba363ff
+    
+
+如果外掛程式 (和其`plugin.xml`檔) 是在 git 存儲庫中的子目錄中,您可以指定它與`:`字元。 `#`字元仍然需要注意:
+
+        $ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
+    
+
+您還可以將合併 git-ref 和子目錄:
+
+        $ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
+    
+
+或者,指定包含`plugin.xml`檔的外掛程式目錄的本地路徑:
+
+        $ cordova plugin add ../my_plugin_dir
+    
+
+## 使用*合併*到自訂的每個平臺
+
+而科爾多瓦允許您輕鬆地部署應用程式的許多不同的平臺,有時你需要添加自訂項。 在這種情況下,你不想修改原始檔案中各種`www`目錄內的頂級`平臺`目錄,因為他們定期更換頂級`www`目錄跨平臺源。
+
+相反,頂級`merges`目錄提供了一個地方來指定資產在特定平臺上部署。 每個特定于平臺的子目錄內`merges`鏡像`www`源樹中,允許您重寫或根據需要添加的檔的目錄結構。 例如,這裡是你如何使用`合併`以提高安卓和亞馬遜火 OS 設備的預設字型大小:
+
+*   編輯 `www/index.html` 檔,添加一個連結到一個額外的 CSS 檔,該檔 `overrides.css` 在這種情況下:
+    
+        <link rel="stylesheet" type="text/css" href="css/overrides.css" />
+        
+
+*   (可選) 創建一個空的 `www/css/overrides.css` 檔,將適用于所有非 Android 生成,防止丟失檔錯誤。
+
+*   創建 `css` 中的子目錄 `merges/android` ,然後添加相應的 `overrides.css` 檔。 指定將覆蓋 12 點預設的字體大小範圍內指定的 CSS `www/css/index.css` ,例如:
+    
+        body { font-size:14px; }
+        
+
+當你重新生成專案時,Android 版本特點的自訂字體大小,而其他人保持不變。
+
+您也可以使用`merges`添加原始的`www`目錄中不存在的檔。 例如,一個應用程式可以將*後退按鈕*的圖形納入 iOS 介面,存儲在`merges/ios/img/back_button.png`,而 Android 版本相反可以捕獲從對應的硬體按鈕的`[backbutton](../../cordova/events/events.backbutton.html)`事件。
+
+## 説明命令
+
+科爾多瓦特點兩三個全域命令,可以説明你,如果你被卡住或遇到的問題。 `help`命令顯示所有可用的科爾多瓦命令和它們的語法:
+
+    $ cordova help
+    $ cordova        # same
+    
+
+此外,你可以在一個特定的命令更詳細的説明。 例如:
+
+    $ cordova run --help
+    
+
+`Info`命令產生的潛在的有用的詳細資訊,如當前安裝的平臺和外掛程式,每個平臺 SDK 版本的 CLI 和`node.js`版本的清單:
+
+    $ cordova info
+    
+
+它提出了對螢幕資訊和捕獲本地`info.txt`檔中的輸出。
+
+**注**: 目前,只有細節在 iOS 和 Android 平臺上的都可用。
+
+## 更新科爾多瓦和您的專案
+
+安裝後的`cordova`實用程式,您可以始終進行更新到最新版本通過運行以下命令:
+
+        $ sudo npm update -g cordova
+    
+
+使用此語法來安裝特定的版本:
+
+        $ sudo npm install -g cordova@3.1.0-0.2.0
+    
+
+運行`cordova -v`來查看當前正在運行哪個版本。 運行更長的清單,其中包括當前版本以及其他可用的版本編號為`npm info`命令:
+
+        $ npm info cordova
+    
+
+科爾多瓦 3.0 是支援這一節中描述的命令列介面的第一個版本。 如果你從 3.0 以前的版本更新,您需要創建一個新專案,如上文所述,然後將舊應用程式資產複製到頂級`www`目錄。 在適用的情況下,更多關於升級到 3.0 的詳情,可用平臺指南中。 一旦你升級到`科爾多瓦`命令列介面並使用`npm 更新`保持最新,更費時所述有程式不再相關。
+
+科爾多瓦 3.0 + 可能仍然需要對專案級別的目錄結構和其他依賴關係的各種變化。 你運行上面的`npm`命令,若要更新本身的科爾多瓦後,您可能需要確保您的專案資源符合最新的版本要求。 運行下面這樣的命令為每個平臺您正在構建:
+
+        $ cordova platform update android
+        $ cordova platform update ios
+        ...etc.


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message