http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/events/events.startcallbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/events/events.startcallbutton.md b/www/docs/zh-cn/3.4.0/cordova/events/events.startcallbutton.md new file mode 100644 index 0000000..deceda4 --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/events/events.startcallbutton.md @@ -0,0 +1,82 @@ +--- +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: startcallbutton +--- + +# startcallbutton + +ç¶ä½¿ç¨è æä¸éå§å¼å«æéæï¼å°è§¸ç¼è©²äºä»¶ã + + document.addEventListener("startcallbutton", yourCallbackFunction, false); + + +## 詳細è³è¨ + +å¦ææ¨éè¦é寫é è¨éå§èª¿ç¨è¡çºæ¨å¯ä»¥è¨»åçºäºä»¶ææªå¨ `startcallbutton` äºä»¶ã + +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå ä¸æ¬¡ `[deviceready](events.deviceready.html)` äºä»¶ç«ç½ã + +## æ¯æ´çå¹³èº + +* é»è 10 + +## å¿«éçç¤ºä¾ + + document.addEventListener("startcallbutton", onStartCallKeyDown, false); + + function onStartCallKeyDown() { + // Handle the start call button + } + + +## å®æ´çç¤ºä¾ + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd"> + <html> + <head> + <title>Start Call Button 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 + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("startcallbutton", onStartCallKeyDown, false); + } + + // Handle the start call button + // + function onStartCallKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/events/events.volumedownbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/events/events.volumedownbutton.md b/www/docs/zh-cn/3.4.0/cordova/events/events.volumedownbutton.md new file mode 100644 index 0000000..a9f2f9a --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/events/events.volumedownbutton.md @@ -0,0 +1,82 @@ +--- +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: volumedownbutton +--- + +# volumedownbutton + +å¨ä½¿ç¨è æä¸æéå·æï¼å°è§¸ç¼è©²äºä»¶ã + + document.addEventListener("volumedownbutton", yourCallbackFunction, false); + + +## 詳細è³è¨ + +å¦ææ¨éè¦é寫é è¨é³ééä½çè¡çºä½ å¯ä»¥è¨»åçºäºä»¶ææªå¨ `volumedownbutton` äºä»¶ã + +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå ä¸æ¬¡ `[deviceready](events.deviceready.html)` äºä»¶ç«ç½ã + +## æ¯æ´çå¹³èº + +* é»è 10 + +## å¿«éçç¤ºä¾ + + document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false); + + function onVolumeDownKeyDown() { + // Handle the volume down button + } + + +## å®æ´çç¤ºä¾ + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd"> + <html> + <head> + <title>Volume Down Button 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 + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false); + } + + // Handle the volume down button + // + function onVolumeDownKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/events/events.volumeupbutton.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/events/events.volumeupbutton.md b/www/docs/zh-cn/3.4.0/cordova/events/events.volumeupbutton.md new file mode 100644 index 0000000..390c11d --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/events/events.volumeupbutton.md @@ -0,0 +1,82 @@ +--- +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: volumeupbutton +--- + +# volumeupbutton + +ç¶ä½¿ç¨è æä¸äºæéå·æï¼å°è§¸ç¼è©²äºä»¶ã + + document.addEventListener("volumeupbutton", yourCallbackFunction, false); + + +## 詳細è³è¨ + +å¦ææ¨éè¦é寫é è¨å·èµ·ä¾çè¡çºä½ å¯ä»¥è¨»åçºäºä»¶ææªå¨ `volumeupbutton` äºä»¶ã + +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå ä¸æ¬¡ `[deviceready](events.deviceready.html)` äºä»¶ç«ç½ã + +## æ¯æ´çå¹³èº + +* é»è 10 + +## å¿«éçç¤ºä¾ + + document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false); + + function onVolumeUpKeyDown() { + // Handle the volume up button + } + + +## å®æ´çç¤ºä¾ + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" + "http://www.w3.org/TR/html4/strict.dtd"> + <html> + <head> + <title>Volume Up Button 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 + // + function onLoad() { + document.addEventListener("deviceready", onDeviceReady, false); + } + + // device APIs are available + // + function onDeviceReady() { + // Register the event listener + document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false); + } + + // Handle the volume up button + // + function onVolumeUpKeyDown() { + } + + </script> + </head> + <body onload="onLoad()"> + </body> + </html> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/plugins/pluginapis.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/plugins/pluginapis.md b/www/docs/zh-cn/3.4.0/cordova/plugins/pluginapis.md new file mode 100644 index 0000000..5ea136f --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/plugins/pluginapis.md @@ -0,0 +1,119 @@ +--- +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 +--- + +# å¤æç¨å¼ç Api + +ç§ç¾å¤ç¦è¹èä¸çµæå°ç Apiï¼åå°æ¡æ·»å åªäºé¡å¤ç Apiï¼å®åéè¦ééå¤æç¨å¼ã + +æ¨å¯ä»¥éé使ç¨[å¤æç¨å¼è¨»å表][1]çææç¾æå¤æç¨å¼æç´¢. + + [1]: http://plugins.cordova.io/ + +å³çµ±çç§ç¾å¤ç¦å¤æç¨å¼éå¦ä¸æç¤ºï¼ + +* [é»æ± çæ ][2] + + > ç£è¦è¨åçé»æ± ççæ ã + +* [ç¸æ©][3] + + > æç²ç §ç使ç¨çè¨åçç¸æ©ã + +* [é£çµ¡äºº][4] + + > èè¨åé£çµ¡äººè³æ庫çå·¥ä½ã + +* [è¨å][5] + + > æ¶éè¨åç¹å®è³è¨ã + +* [è¨åéå ï¼å é度è¨ï¼][6] + + > é²å ¥è¨åçåä½ææå¨ã + +* [è¨åå®ä½ (æåé)][7] + + > ç²å該è¨åçæåçæ¹åã + +* [å°è©±][8] + + > è¦è¦ºè¨åéç¥ã + +* [æªæ¡ç³»çµ±][9] + + > ææ¥å°æ¬æ©æªæ¡ç³»çµ±éé JavaScriptã + +* [æªæ¡å³è¼¸][10] + + > ææ¥å°æ¬æ©æªæ¡ç³»çµ±éé JavaScriptã + +* [å°çå®ä½][11] + + > è®æèå°æ¨æç¨ç¨å¼çä½ç½®ã + +* [å ¨çå][12] + + > åç¨ç¹å®äºå°åè¨å®çç©ä»¶è¡¨ç¤ºçå½¢å¼ã + +* [InAppBrowser][13] + + > ååå¦ä¸åæç¨ç¨å¼ä¸çç覽å¨å¯¦ä¾ç Urlã + +* [åªé«][14] + + > é製åææ¾é³è¨æªã + +* [åªé«æç²][15] + + > æ·åè£ç½®çåªé«æç²æç¨ç¨å¼ä½¿ç¨çåªé«æªæ¡ã + +* [網路è³è¨ ï¼é£æ¥ï¼][16] + + > å¿«é檢æ¥ç¶²è·¯çæ åè窩網路çè³è¨ã + +* [éå±][17] + + > 顯示åé±èçæç¨ç¨å¼çåå§è¢å¹ã + +* [æ¯å][18] + + > æ¯åè¨åç APIã + + [2]: https://github.com/apache/cordova-plugin-battery-status/blob/master/doc/index.md + [3]: https://github.com/apache/cordova-plugin-camera/blob/master/doc/index.md + [4]: https://github.com/apache/cordova-plugin-contacts/blob/master/doc/index.md + [5]: https://github.com/apache/cordova-plugin-device/blob/master/doc/index.md + [6]: https://github.com/apache/cordova-plugin-device-motion/blob/master/doc/index.md + [7]: https://github.com/apache/cordova-plugin-device-orientation/blob/master/doc/index.md + [8]: https://github.com/apache/cordova-plugin-dialogs/blob/master/doc/index.md + [9]: https://github.com/apache/cordova-plugin-file/blob/master/doc/index.md + [10]: https://github.com/apache/cordova-plugin-file-transfer/blob/master/doc/index.md + [11]: https://github.com/apache/cordova-plugin-geolocation/blob/master/doc/index.md + [12]: https://github.com/apache/cordova-plugin-globalization/blob/master/doc/index.md + [13]: https://github.com/apache/cordova-plugin-inappbrowser/blob/master/doc/index.md + [14]: https://github.com/apache/cordova-plugin-media/blob/master/doc/index.md + [15]: https://github.com/apache/cordova-plugin-media-capture/blob/master/doc/index.md + [16]: https://github.com/apache/cordova-plugin-network-information/blob/master/doc/index.md + [17]: https://github.com/apache/cordova-plugin-splashscreen/blob/master/doc/index.md + [18]: https://github.com/apache/cordova-plugin-vibration/blob/master/doc/index.md + +éäºå¤æç¨å¼ææªéè±èªç¿»è¯å¯ä»¥ç¼ç¾ççç§ç¾å¤ç¦ææªçèçæ¬ã使ç¨é常å³ä¸è§çéå網ç«å¨ä¸æå¼åè½è¡¨åæçæ¬ã http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/storage/database/database.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/database/database.md b/www/docs/zh-cn/3.4.0/cordova/storage/database/database.md new file mode 100644 index 0000000..8dfb054 --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/storage/database/database.md @@ -0,0 +1,119 @@ +--- +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: è³æ庫 +--- + +# è³æ庫 + +æä¾å° SQL è³æ庫ç訪åã + +## æ¹æ³ + +* **交æè¨é**ï¼ éè¡è³æ庫äºåã + +* **changeVersion**: å è¨±è ³æ¬èªåé©èççæ¬èåæ´æ°æ¶æ§ææ´æ¹å®ã + +## 詳細è³è¨ + +`window.openDatabase()`æ¹æ³è¿å `Database` çç©ä»¶ã + +## æ¯æ´çå¹³èº + +* Android 系統 +* é»èææ© WebWorks ï¼OS 6.0 åæ´é«ï¼ +* iOS +* Tizen + +## 交æå¿«éç¤ºä¾ + + 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.code); + } + + function successCB() { + alert("success!"); + } + + var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000); + db.transaction(populateDB, errorCB, successCB); + + +## æ´æ¹çæ¬å¿«éç¤ºä¾ + + var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000); + db.changeVersion("1.0", "1.1"); + + +## å®æ´çç¤ºä¾ + + <!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(tx, err) { + alert("Error processing SQL: "+err); + } + + // Transaction success callback + // + function successCB() { + alert("success!"); + } + + </script> + </head> + <body> + <h1>Example</h1> + <p>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/3.4.0/cordova/storage/localstorage/localstorage.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/localstorage/localstorage.md b/www/docs/zh-cn/3.4.0/cordova/storage/localstorage/localstorage.md new file mode 100644 index 0000000..f6d5dc7 --- /dev/null +++ b/www/docs/zh-cn/3.4.0/cordova/storage/localstorage/localstorage.md @@ -0,0 +1,124 @@ +--- +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: localStorage +--- + +# localStorage + +æä¾å° W3C [Web åå²ä»é¢][1]ç訪å + + [1]: http://dev.w3.org/html5/webstorage/#the-localstorage-attribute + + var permanentStorage = window.localStorage; + var tempStorage = window.sessionStorage; + + +## æ¹æ³ + +* **éµ**ï¼ è¿åå¨æå®çä½ç½®çéµçå稱ã + +* **getItem**ï¼ è¿åç±æå®çéµæ¨èçé ã + +* **setItem**ï¼ åé ä¸åéµæ§çé å¼ã + +* **removeItem**: åªé¤æ¨èç±æå®éµçé ã + +* **æ¸ é¤**ï¼ ä¸ç§»é¤ææéµ/å¼å°ã + +## 詳細è³è¨ + +`window.localStorage`ä»é¢å¯¦ç¾ï¼W3C [Web åå²ä»é¢][2]ã æç¨ç¨å¼å¯ä»¥ä½¿ç¨å®ä¾ä¿åæ°¸ä¹ è³æ使ç¨éµ-å¼å°ã `window.sessionStorage`ä»é¢å¨æ¯åæ¹é¢ï¼é¤äºï¼ææè³æé½è¢«é½æ¸ é¤æç¨ç¨å¼ééæ¯æ¬¡çå·¥ä½æ¹å¼ç¸åã æ¯åè³æ庫æä¾äºå®ç¨çå½å空éã + + [2]: http://dev.w3.org/html5/webstorage/ + +## æ¯æ´çå¹³èº + +* Android 系統 +* é»èææ© WebWorks ï¼OS 6.0 åæ´é«ï¼ +* iOS +* Tizen +* Windows Phone 7 å 8 + +## éµå¿«éç¤ºä¾ + + var keyName = window.localStorage.key(0); + + +## è¨ç½®çå°æ¡çå¿«éç¤ºä¾ + + window.localStorage.setItem("key", "value"); + + +## ç²åå°æ¡çå¿«éç¤ºä¾ + + var value = window.localStorage.getItem("key"); + // value is now equal to "value" + + +## åªé¤å°æ¡å¿«éç¤ºä¾ + + window.localStorage.removeItem("key"); + + +## æ¸ é¤å¿«éç¤ºä¾ + + window.localStorage.clear(); + + +## å®æ´çç¤ºä¾ + + <!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() { + window.localStorage.setItem("key", "value"); + var keyname = window.localStorage.key(i); + // keyname is now equal to "key" + var value = window.localStorage.getItem("key"); + // value is now equal to "value" + window.localStorage.removeItem("key"); + window.localStorage.setItem("key2", "value2"); + window.localStorage.clear(); + // localStorage is now empty + } + + </script> + </head> + <body> + <h1>Example</h1> + <p>localStorage</p> + </body> + </html> + + +## Windows Phone 7 çæªç + +é»æ¨è¨æ³æ¯*æ²æ*å¯ç¨ç Windows Phone 7ã ä¸å®è¦ä½¿ç¨ `setItem` æ `getItem` ï¼èä¸æ¯ç´æ¥å¾åå²ç©ä»¶ï¼å¦ä¾¿æ·éµ`window.localStorage.someKey`. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.4.0/cordova/storage/parameters/display_name.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/parameters/display_name.md b/www/docs/zh-cn/3.4.0/cordova/storage/parameters/display_name.md new file mode 100644 index 0000000..2087956 --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/parameters/name.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/parameters/name.md b/www/docs/zh-cn/3.4.0/cordova/storage/parameters/name.md new file mode 100644 index 0000000..c72d2f3 --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/parameters/size.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/parameters/size.md b/www/docs/zh-cn/3.4.0/cordova/storage/parameters/size.md new file mode 100644 index 0000000..0df07db --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/parameters/version.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/parameters/version.md b/www/docs/zh-cn/3.4.0/cordova/storage/parameters/version.md new file mode 100644 index 0000000..e0a8a3b --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/sqlerror/sqlerror.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/sqlerror/sqlerror.md b/www/docs/zh-cn/3.4.0/cordova/storage/sqlerror/sqlerror.md new file mode 100644 index 0000000..67e2199 --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/sqlresultset/sqlresultset.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/sqlresultset/sqlresultset.md b/www/docs/zh-cn/3.4.0/cordova/storage/sqlresultset/sqlresultset.md new file mode 100644 index 0000000..b8efb5c --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md b/www/docs/zh-cn/3.4.0/cordova/storage/sqlresultsetrowlist/sqlresultsetrowlist.md new file mode 100644 index 0000000..dea416d --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/sqltransaction/sqltransaction.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/sqltransaction/sqltransaction.md b/www/docs/zh-cn/3.4.0/cordova/storage/sqltransaction/sqltransaction.md new file mode 100644 index 0000000..ab577ba --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/cordova/storage/storage.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/storage.md b/www/docs/zh-cn/3.4.0/cordova/storage/storage.md new file mode 100644 index 0000000..082c3e4 --- /dev/null +++ b/www/docs/zh-cn/3.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/ + +**Windows Phone 7 æªç**ï¼ é»æ¨è¨æ³æ¯*ä¸*æä¾ï¼æ以ä¸å®è¦ä½¿ç¨ `setItem` æ `getItem` ï¼èä¸æ¯å¨ä½çºä¾¿æ·éµç´æ¥å¾åå²çç©ä»¶ï¼`window.localStorage.someKey`. + +## WebSQL + +æ¤ API æ¯å¨åºå±¤ web è¦åä¸å¯ç¨ã [Web SQL è³æ庫è¦ç¯][3]æä¾æ´å¤çåè½å ¨é¢çè³æ庫表訪åéé SQL æ¥è©¢ã + + [3]: http://dev.w3.org/html5/webdatabase/ + +å¨ä»¥ä¸å¹³èºæ¯æ´ WebSQLï¼ + +* Android 系統 +* é»è 10 +* iOS +* Tizen + +## IndexedDB + +æ¤ API æ¯å¨åºå±¤ web è¦åä¸å¯ç¨ã[ç´¢å¼ç DB][4]æä¾æ¯èªçºæ´å¤çåè½ï¼ä½æ¯ WebSQL è¼å°ã + + [4]: http://www.w3.org/TR/IndexedDB/ + +å¨ä»¥ä¸å¹³èºæ¯æ´ IndexedDBï¼ + +* Windows Phone 8 +* é»è 10 + +## åºæ¼å¤æç¨å¼çé¸é + +é¤äºä¸é¢ååºç 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/3.4.0/cordova/storage/storage.opendatabase.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/cordova/storage/storage.opendatabase.md b/www/docs/zh-cn/3.4.0/cordova/storage/storage.opendatabase.md new file mode 100644 index 0000000..13dad8a --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/guide/appdev/privacy/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/guide/appdev/privacy/index.md b/www/docs/zh-cn/3.4.0/guide/appdev/privacy/index.md new file mode 100644 index 0000000..efe912e --- /dev/null +++ b/www/docs/zh-cn/3.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/3.4.0/guide/appdev/whitelist/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/guide/appdev/whitelist/index.md b/www/docs/zh-cn/3.4.0/guide/appdev/whitelist/index.md new file mode 100644 index 0000000..e41a911 --- /dev/null +++ b/www/docs/zh-cn/3.4.0/guide/appdev/whitelist/index.md @@ -0,0 +1,141 @@ +--- +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: ç½åå®æå +--- + +# ç½åå®æå + +åç½æ¯ä¸ç¨®å®å ¨æ¨¡å¼ï¼æ§å¶è¨ªåå°æ¨æç¨ç¨å¼ææ²ææ§å¶çå¤é¨åã ç§ç¾å¤ç¦çé è¨å®å ¨æ§ååå 許訪åçä»»ä½ç¶²ç«ã å¨ç§»åä¹åæ¨å¨çç¢ä¸çæç¨ï¼æå¶è¨ç½åå®åå 許訪åç¹å®ç網路ååååã + +ç§ç¾å¤ç¦éµå¾ª[W3C æ§ä»¶è¨ªå][1]è¦ç¯ï¼å®ä¾è³´äº `<access>` ä¸æç¨ç¨å¼çå ç´ `config.xml` æªä»¥åç¨å°ç¹å®åç網路訪åã å°æ¼ä¾è³´äºæè¿°çå½ä»¤åä»é¢ CLI å·¥ä½æµçå°æ¡ï¼æ¤æªä½æ¼å°æ¡çé ç´ç®éã å¦åçºç¹å®äºå¹³èºçç¼å±éè·¯ï¼ä½ç½®ååºä»¥ä¸åç¯ã ï¼æ¯åå¹³èºä¸è¦å種平èºæåç詳細è³è¨ï¼ã + + [1]: http://www.w3.org/TR/widgets-access/ + +ä¸é¢ç示ä¾æ¼ç¤ºç½åå®ä¸çèªæ³ï¼ + +* [Google.com][2]訪åï¼ + + <access origin="http://google.com" /> + + +* å°å®å ¨[google.com][3]ç訪å ( `https://` ): + + <access origin="https://google.com" /> + + +* åå[maps.google.com][4]訪åï¼ + + <access origin="http://maps.google.com" /> + + +* å°ææåå[google.com][2]ï¼ä¾å¦[mail.google.com][5]å[docs.google.com][6]ç訪åï¼ + + <access origin="http://*.google.com" /> + + +* å°*ææ*çåï¼ä¾å¦ï¼ [google.com][2]å[developer.mozilla.org][7]ç訪åï¼ + + <access origin="*" /> + + + éæ¯æ°åµå»ºç CLI å°æ¡çé è¨å¼ã + + [2]: http://google.com + [3]: https://google.com + [4]: http://maps.google.com + [5]: http://mail.google.com + [6]: http://docs.google.com + [7]: http://developer.mozilla.org + +## äºé¦¬éç« OS ç½ + +å¨æ¾å°ç¹å®å¹³èºç½è¦å`res/xml/config.xml`. + +## Android ç½ + +å¨æ¾å°ç¹å®å¹³èºç½è¦å`res/xml/config.xml`. + +**注**ï¼ å¨ Android 2.3 ä¸åä¹åï¼åç½å é©ç¨äº `href` çè¶ é£çµï¼ä¸å¼ç¨çè³æºï¼å¦åååè ³æ¬ã æ¡åæ¥é©ï¼é¿å å¾è¢«æ³¨å ¥å°æç¨ç¨å¼çè ³æ¬ã + +å°èªå°éç½åå®åéé `href` çè¶ é£çµæå°è´è¦æéé è¨ç覽å¨ä¸ï¼èä¸æ¯å¨æç¨ç¨å¼ä¸çé ãï¼æ¯è¼éå°ä¸é¢æå°ç iOS çè¡çº)ã + +## iOS ç½ + +該平èºçç½è¦åå½åçæç¨ç¨å¼ç®éä¸æ¾å° `config.xml` æªã + +æ²æä¸ååå®ï¼å¦æå®çèµ·æº `www.apache.org` èä¸æ¯ `http://www.apache.org` ï¼é è¨çºææç `http` ï¼ `https` ï¼ `ftp` ï¼å `ftps` è¨ç«ã + +å¨ iOS å¹³èºä¸çè¬ç¨åå æ¯æ¯å¨[W3C æ§ä»¶è¨ªå][1]è¦ç¯æ´éæ´»ã ä¾å¦ï¼ä»¥ä¸è¨ªåææåååé 層網åå¦ `.com` å `.net` ï¼ + + <access origin="*.google.*" /> + + +èä¸ææåºçå°éç½åå®åééå°èªç Android å¹³èºä¸åçæ¯ `href` iOS ä¸çè¶ é£çµå¯ä»¥é²æ¢é é¢æéå¨ææã + +## é»è 10 ç½ + +å¨æ¾å°ç½è¦å`www/config.xml`. + +é»è 10 ä½ä½¿ç¨è¬ç¨åå æå¥äºå ¶ä»å¹³èºå ©ç¨®æ¹å¼ï¼ + +* éé訪åä»»ä½å §å®¹ `XMLHttpRequest` å¿ é 顯å¼è²æã è¨ç½® `origin="*"` ä¸å¨é種æ æ³ä¸å·¥ä½ã å¦å¤ï¼ææ web å®å ¨æ§å¯è½æé½ç¦ç¨ä½¿ç¨ `WebSecurity` é»èææ©é ç½®ä¸æè¿°çé¦é¸é ï¼ + + <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" /> + +(æéæ¯æ´ç詳細è³è¨ï¼è«åé±é»èçææª[訪åå ç´ ][8]ä¸.) + + [8]: https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html + +## 3.1.0 ç iOS è®å + +ä¹å 3.1.0 çï¼ç§ç¾å¤ç¦ iOS å æ¬ä¸äºéæ¨æºæ´å±å whilelisting è¨ç«å ¶ä»ç§ç¾å¤ç¦å¹³èºé½æ¯æ´çã èª 3.1.0ã iOS ç½åå®ç¾å¨ç¬¦åè³æºç½åå®èªæ³æè¿°äºæ¬ææªçé é¨ã å¦ææ¨å¾ pre-3.1.0ã åç´å使ç¨éäºæ´å±ï¼æ¨å¯è½éè¦æ´æ¹æ¨ `config.xml` ï¼ä»¥åä¸æ¨£ç¹¼çºç½çµç¸åçè³æºæªã + +å ·é«èè¨ï¼éäºæ¨¡å¼éè¦æ´æ°ï¼ + +* `apache.org`ï¼ç¡åå®ï¼ï¼ éå°å åå¹é `http` ï¼ `https` ï¼ `ftp` ï¼å `ftps` çåå®ã å°æ´æ¹çº" `*://apache.org/*` "ï¼å æ¬ææåå®ï¼æé½å æ¬æ¨éè¦æ¯æ´çæ¯ååå®çç·ã + +* `http://apache.*`ï¼è¬ç¨åå åçä¸ç«¯ï¼ï¼ éå°å åå¹é çææé ç´-ç´å¥-åï¼å æ¬ææå¯è½çå ©ååæ¯ Tld ï¼ä½ä¸æ¯æç¨ååæ¡ã co.uk)ã çºæ¯å TLDï¼æ¨å¯¦éä¸æ§å¶ï¼ä¸¦ä¸éè¦å°ç½åå®ä¸å æ¬ä¸æ¢ç·ã + +* `h*t*://ap*he.o*g`ï¼é¨æ©ç¼ºå°åæ¯çè¬ç¨åå ï¼ï¼ ä¸åæ¯æ´éäº ï¼æ´æ¹å å«çºæ¯ååååå®ï¼ä½ 實éä¸éè¦å°ç½åå®ä¸çä¸ç·ã + +## Windows Phone ç½ + +Windows Phone 7 å 8 çç½è¦åç¼ç¾å¨æç¨ç¨å¼ä¸ç `config.xml` æªã + +## Tizen ç½ + +ç½è¦åç¼ç¾å¨æç¨ç¨å¼ä¸ç `config.xml` æªã å¨å¹³èºä¸å樣ä¾è³´äº `subdomains` 屬æ§ä½çºé»èå¹³èºã (æéæ¯æ´ç詳細è³è¨ï¼è«åé± Tizen çææª[訪åå ç´ ][9]ä¸.) + + [9]: 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/3.4.0/guide/cli/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.4.0/guide/cli/index.md b/www/docs/zh-cn/3.4.0/guide/cli/index.md new file mode 100644 index 0000000..2936bd4a --- /dev/null +++ b/www/docs/zh-cn/3.4.0/guide/cli/index.md @@ -0,0 +1,379 @@ +--- +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ï¼ +* é»è 10 ï¼Macã Linuxã Windowsï¼ +* Windows Phone 7 (Windows) +* Windows Phone 8 (Windows) +* Windows 8 (Windows) +* ç«çç覽å¨ä½æ¥ç³»çµ± ï¼Macã Linuxã Windowsï¼ + +å¨ Mac ä¸ï¼å½ä»¤åæ¯å¯éé*çµç«¯*æç¨çãå¨ PC ä¸ï¼å®æ¯å¯ä½çº*å½ä»¤æ示符*ä¸*é 件*. + +å°±è¶æå¯è½æ¯ä½ å¨ CLI éè¡å¾ä¸åçæ©å¨ï¼æ´å æ義ä¿æé 端åå§ç¨å¼ç¢¼å²å庫ï¼ä½ æä¸å°æ¬å°å·¥ä½ç®éçè³ç¢ã + +è¥è¦å®è£ `cordova` å½ä»¤åå·¥å ·ï¼è«æç §éäºæ¥é©æä½ï¼ + +1. ä¸è¼ä¸¦å®è£[Node.js][1]ãå®è£å®æå¾ï¼æ¨æ該è½å¤ èª¿ç¨ `node` æ `npm` å¨å½ä»¤åä¸ã + +2. å®è£ `cordova` 實ç¨ç¨å¼ãå¨ Unix ä¸ï¼é¦ç¢¼çé¡å¤ `sudo` å½ä»¤å¯è½éè¦å®è£éç¼å¯¦ç¨ç¨å¼ä¸ä»¥å ¶ä»æ¹å¼éå¶ç®éï¼ + + $ sudo npm install -g cordova + + + å®è£æ¥èªå¯è½æç¢çé¯èª¤çä»»ä½å·²å¸è¼å¹³èº Sdkãå®è£å®æå¾ï¼æ¨æ該è½å¤ éè¡ `cordova` å½ä»¤åä¸ã + + **注**ï¼ `-g` æ¨èªä¸é¢å訴æ å®®å ¨åå®è£ç§ç¾å¤ç¦ã æ¨å¯è½éè¦æ·»å å°æ¨çè·¯å¾ï¼çºäºèª¿ç¨å ¨åçæ å®®ç®éå®è£æ 宮模çµã å¨ Windows ä¸ï¼æ å®®é常å¯ä»¥æ¾å°å¨ `C:\Users\username\AppData\Roaming\npm` åå¨ Unix ä¸`/usr/local/share/npm`. + + [1]: http://nodejs.org/ + +## åµå»ºæç¨ç¨å¼ + +è½è³ç®éä½ç½®æ¨ç¶è·æ¨çåå§ç¨å¼ç¢¼ï¼ä¸¦éè¡ä»¥ä¸å½ä»¤ï¼ + + $ 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 ä½æ¥ç³»çµ±ï¼ + + $ cordova platform add wp7 + $ cordova platform add wp8 + $ cordova platform add windows8 + $ cordova platform add amazon-fireos + $ cordova platform add android + $ cordova platform add blackberry10 + $ cordova platform add 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/` è³æ夾é¤éä½ ç¥éä½ æ£å¨åä»éº¼ï¼æç¹å¥å¨ææªä¸ä»¥å ¶ä»æ¹å¼åç¥ã éæ¯å çºä¸çæª `/platforms/` direcotry å°è¢«è¦èä¸æºåæå¤æç¨å¼éæ°å®è£ã + +å¦ææ¨å¸æå¨æ¤æï¼ä½ å¯ä»¥ä½¿ç¨ 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ï¼ç¶å¾éè¡ä¸åç¹å®çè¨åååï¼ååå®æ ¹æå ¶é è¨è¡çºï¼ + +![][2] + + [2]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_init.png + +è·é²è `cordova emulate` å½ä»¤å·æ°é¡¯ç¤ºçææ°æç¨ï¼ç¾å·²å¾ä¸»ç«é¢ç¼å°ç模æ¬ç¨å¼ååï¼ + +![][3] + + [3]: {{ site.baseurl }}/static/img/guide/cli/android_emulate_install.png + +æè ï¼å¯ä»¥å°ææ©æå ¥æ¨çé»è ¦åç´æ¥æ¸¬è©¦æç¨ç¨å¼ï¼ + + $ cordova run android + + +å¨éè¡æ¤å½ä»¤ä¹å, æ¨éè¦è¨ç½®çè¨åé²è¡æ¸¬è©¦ï¼ä¹å¾æç¼çè®åï¼çºæ¯åå¹³èºçç¨å¼ã å¨ Android åäºé¦¬éç« OS è¨åï¼ä½ å°å¿ é åç¨è¨åä¸ç**USB 調試**çé¸é åæ許添å USB é© åç¨å¼æ ¹ææ¨ç¼å±å°è®å·¥ä½ã æ¯åå¹³èºçè¦æ±ç詳細è³è¨ï¼è«åé±å¹³èºæåã + +## æ·»å å¤æç¨å¼çåè½ + +çæåæ¥çä¸åæ°å°æ¡æï¼å°é¡¯ç¤ºé è¨çæç¨ç¨å¼ä¸æå¾å¤ã æ¨å¯ä»¥ä¿®æ¹è©²æç¨ç¨å¼å¨è¨±å¤æ¹é¢ï¼å©ç¨æ¨æºç web æè¡ï¼ä½æç¨ç¨å¼ç·å¯çè¯ç¹«ï¼èå種è¨åç´åè½ï¼æ¨éè¦æ·»å å¤æç¨å¼ï¼æä¾å°æ ¸å¿ç§ç¾å¤ç¦ Api ç訪åã + +*å¤æç¨å¼*æ¯æé»çè¼å ¥é 代碼çæä¾çæ¬æ©çµä»¶çä»é¢ã æ¨å¯ä»¥è¨è¨æ¨èªå·±çå¤æç¨å¼ä»é¢ï¼ä¾å¦ï¼è¨è¨ä¸åæ··åæç¨ç¨å¼ï¼èæ¬æ©çµä»¶æ··åç§ç¾å¤ç¦ web è¦åæã ï¼è«åé±åµå ¥ WebViews åå¤æç¨å¼éç¼æåç詳細è³è¨ãæ´å¸¸è¦çæ¯ï¼æ¨å°æ·»å å¤æç¨å¼ï¼ä»¥ä¾¿åç¨ç§ç¾å¤ç¦çåºæ¬è¨åç´åè½è©³ç´°ç API Reference ä¸ä¹ä¸ã å¯ä»¥å¨[plugins.cordova.io][4]ç¼ç¾éäºå¤æç¨å¼ï¼å æ¬ç¤¾æï¼ææä¾çéå å¤æç¨å¼çæ¸ å®ã ä½ å¯ä»¥ä½¿ç¨ CLI ä¾æç´¢å¤æç¨å¼å¾æ¤è¨»å表ã ä¾å¦ï¼æç´¢ `bar` å `code` ç¢çå®åçµæç¸å¹é éå ©åè©ä½çºåå串ä¸åå大å°å¯«ï¼ + + [4]: http://plugins.cordova.io/ + + $ cordova plugin search bar code + + com.phonegap.plugins.barcodescanner - Scans Barcodes + + +å æç´¢ `bar` æéååµæ¶ççåæ´å¤ççµæï¼ + + org.apache.cordova.statusbar - Cordova StatusBar Plugin + + +`cordova plugin add`å½ä»¤éè¦æ¨æå®çå¤æç¨å¼ä»£ç¢¼çåå²åº«ã è«æ³¨æç¶ä½ éµå¾ª Web å°æ¡éç¼å·¥ä½æµåä½¿ç¨ CLIï¼CLI æç §é¡§å°é©ç¶çä½ç½®çºæ¯åå¹³èºæ·»å å¤æç¨å¼ç代碼ã (å¦æä½ æ¯å¨æ¬æ©å°æ¡éç¼å·¥ä½æµï¼æ¨ææ·»å å¤æç¨å¼ä½¿ç¨ Plugman ï¼é裡æåé£çµï¼ï¼å¤æ¬¡çºæ¯åå¹³èº)ã + +é裡æ¯å¦ä½ä½¿ç¨ CLI å°åè½æ·»å å°æç¨ç¨å¼ç示ä¾ï¼ + +* åºæ¬è¨åè³è¨ ï¼è¨å APIï¼ï¼ + + $ cordova plugin add org.apache.cordova.device + + +* 網路é£æ¥åé»æ± äºä»¶ï¼ + + $ cordova plugin add org.apache.cordova.network-information + $ cordova plugin add org.apache.cordova.battery-status + + +* å é度è¨ã æåéã åå°çå®ä½ï¼ + + $ cordova plugin add org.apache.cordova.device-motion + $ cordova plugin add org.apache.cordova.device-orientation + $ cordova plugin add org.apache.cordova.geolocation + + +* ç¸æ©ã åªé«éæåæç²ï¼ + + $ cordova plugin add org.apache.cordova.camera + $ cordova plugin add org.apache.cordova.media-capture + $ cordova plugin add org.apache.cordova.media + + +* 訪åè¨åæ網路 ï¼æª APIï¼ ä¸çæªï¼ + + $ cordova plugin add org.apache.cordova.file + $ cordova plugin add org.apache.cordova.file-transfer + + +* ééå°è©±æ¹å¡ææ¯åç¼åºéç¥ï¼ + + $ cordova plugin add org.apache.cordova.dialogs + $ cordova plugin add org.apache.cordova.vibration + + +* é£çµ¡äººï¼ + + $ cordova plugin add org.apache.cordova.contacts + + +* å ¨çåï¼ + + $ cordova plugin add org.apache.cordova.globalization + + +* éå±ï¼ + + $ cordova plugin add org.apache.cordova.splashscreen + + +* æéæ°çç覽å¨è¦çª (InAppBrowser): + + $ cordova plugin add org.apache.cordova.inappbrowser + + +* 調試主æ§å°ï¼ + + $ cordova plugin add org.apache.cordova.console + + +ä½¿ç¨ `plugin ls` ï¼æ `plugin list` ï¼æ `plugin` æ¬èº«ï¼ æ¥çç¶åå·²å®è£çå¤æç¨å¼ãæ¯å顯示ç±å ¶èå¥ç¢¼ï¼ + + $ cordova plugin ls # or 'plugin list' + [ 'org.apache.cordova.console' ] + + +è¥è¦åªé¤æåå¤æç¨å¼ï¼å®ééå¼ç¨ç¸åçèå¥ç¢¼åºç¾å¨è©²æ¸ å®ä¸ãä¾å¦ï¼é裡æ¯ä½ ææ麼移é¤èª¿è©¦ä¸»æ§å°æ¯æ´å¾ä¸åç¼ä½çæ¬ï¼ + + $ cordova plugin rm org.apache.cordova.console + $ cordova plugin remove org.apache.cordova.console # same + + +ä½ å¯ä»¥å¤§éåªé¤ææ·»å çå¤æç¨å¼ééæå®å¤ååæ¸çæ¯åå½ä»¤ï¼ + + $ cordova plugin add org.apache.cordova.console org.apache.cordova.device + + +## é«ç´çå¤æç¨å¼é¸é + +ç¶æ·»å å¤æç¨å¼ï¼å¹¾åé¸é å 許æ¨æå®å¾ä½èç²å該å¤æç¨å¼ã ä¸é¢ç示ä¾ä½¿ç¨ç¥å `registry.cordova.io` 註å表åå¤æç¨å¼æå®ç `id` ï¼ + + $ cordova plugin add org.apache.cordova.console + + +`id`éå¯è½å æ¬å¤æç¨å¼ççæ¬è碼å¾, 追å `@` åå ã`latest`çæ¬æ¯ææ°çæ¬çå¥åãä¾å¦ï¼ + + $ cordova plugin add org.apache.cordova.console@latest + $ cordova plugin add org.apache.cordova.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 + + +å¦æå¤æç¨å¼ (åå ¶ `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` å §çé ç´ç®é `platforms` ç®éï¼ï¼å çºä»åå®ææ´æèé ç´ `www` ç®éç跨平èºæºã + +ç¸åï¼é ç´ `merges` ç®éæä¾äºä¸åæå®è³ç¢å¨ç¹å®å¹³èºä¸é¨ç½²çå°æ¹ã æ¯åç¹å®äºå¹³èºçåç®éå § `merges` é¡åçç®éçµæ§ç `www` æºæ¨¹ä¸ï¼å¾èå 許æ¨é寫ææ ¹æéè¦æ·»å çæªã ä¾å¦ï¼å¨é裡æ¯å¦ä½ä½ å¯è½æä½¿ç¨ `merges` ä¾æ¨å Android åäºé¦¬éç« 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 + + +`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 ç詳細è³è¨æ¯å¯ç¨çå¹³èºæåä¸ã ä¸æ¦ä½ åç´å° `cordova` çå½ä»¤åä»é¢åä½¿ç¨ `npm update` å¾ ç¶åï¼é£è£¡ææè¿°çæ´èæéç¨ä¸åç¸éã + +ç§ç¾å¤ç¦ 3.0 + å¯è½ä»ç¶éè¦å°å°æ¡ç´å¥çç®éçµæ§åå ¶ä»ä¾è³´éä¿çå種è®åã å¨æ¨éè¡ `npm` å½ä»¤ä¸é¢æ´æ°ç§ç¾å¤ç¦æ¬èº«ï¼æ¨å¯è½éè¦ç¢ºä¿æ¨çå°æ¡è³æºç¬¦åææ°ççæ¬è¦æ±ã éè¡ä¸é¢é樣çå½ä»¤çºæ¯åå¹³èºæ¨æ£å¨æ§å»ºï¼ + + $ cordova platform update android + $ cordova platform update ios + ...etc. --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org