http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/blackberry10/upgrading.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/blackberry10/upgrading.md b/www/docs/zh-cn/6.x/guide/platforms/blackberry10/upgrading.md new file mode 100644 index 0000000..6730ddb --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/blackberry10/upgrading.md @@ -0,0 +1,468 @@ +--- +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: åç´é»è 10 +--- + +# åç´é»è 10 + +æ¬æåæ¼ç¤ºå¦ä½ä¿®æ¹é»èææ©çå°æ¡å¾ç§ç¾å¤ç¦çèçæ¬é²è¡åç´ã 大夿¸éäºèªªæé©ç¨äºèèéçåé¢çå½ä»¤åå·¥å ·åµå»ºçå°æ¡ `cordova` CLI 實ç¨ç¨å¼ã å½ä»¤åä»é¢è³è¨ï¼è«åé±å¦ä½æ´æ°ç CLI çæ¬ã + +## å¾ 3.1.0 åç´å° 3.2.0 + +çºåµå»ºçç§ç¾å¤ç¦ CLI çå°æ¡ï¼ + +1. æ´æ° `cordova` CLI çæ¬ãè«åé±å½ä»¤åä»é¢ã + +2. éè¡`cordova platform update blackberry` + +å°æ¼ä¸ä½¿ç¨ CLI ç§ç¾å¤ç¦åµå»ºçå°æ¡ï¼è«éè¡ï¼ + + bin/æ´æ° < project_path > + + +## å¾ 3.0.0 åç´å° 3.1.0 + +1. åµå»ºæ°ç Apache ç§ç¾å¤ç¦ 3.1.0 å°æ¡ä½¿ç¨ CLIï¼ç§ç¾å¤ç¦ï¼å¦æè¿°çå½ä»¤åä»é¢ã + +2. æ·»å æ¨çå¹³èºå°ç§ç¾å¤ç¦å°æ¡ä¸ï¼ä¾å¦ï¼`cordova +platform add blackberry10`. + +3. è¤è£½çåå§å°æ¡å §å®¹ `www` ç®éå° `www` ç®é卿¨åååµå»ºçç§ç¾å¤ç¦å°æ¡çæ ¹ç®éã + +4. è¤è£½æè¦èåå§å°æ¡ä¸ç任使¬æ©è³ç¢ ( `Resources` ï¼çç.) + +5. è¤è£½ `config.xml` æªå° `www` ç®éä¸ï¼ä¸¦åªé¤ä»»ä½å¤æç¨å¼å®ç¾©ãæ¨éè¦ä¿®æ¹é裡çèä¸å¨å¹³èºç®éå §çè¨ç½®ã + +6. 使ç¨ç§ç¾å¤ç¦ CLI å·¥å ·ä¾å®è£æ¨éè¦çä»»ä½å¤æç¨å¼ã è«æ³¨æ CLI èçæææ ¸å¿ Api ä½çºå¤æç¨å¼ï¼æä»¥ä»åå¯è½éè¦æ·»å ã åªæå¤æç¨å¼æ¨è¨ 3.0.0 å䏿è CLI ç¸å®¹ã + +7. çæä¸¦æ¸¬è©¦ã + +è«æ³¨æï¼CLI å®å ¨æ¯æ´ BlackBerry10 å¹³èºãPlayBook å BBOSï¼è«åé±çæ¬ 2.9.0 ç§ç¾å¤ç¦å䏿¹ã + +## å¾ 2.9.0 åç´å° CLI ï¼3.0.0) + +1. åµå»ºæ°ç Apache ç§ç¾å¤ç¦ 3.0.0 å°æ¡ä½¿ç¨ CLIï¼ç§ç¾å¤ç¦ï¼å¦æè¿°çå½ä»¤åä»é¢ã + +2. æ·»å æ¨çå¹³èºå°ç§ç¾å¤ç¦å°æ¡ä¸ï¼ä¾å¦ï¼`cordova +platform add blackberry10`. + +3. è¤è£½çåå§å°æ¡å §å®¹ `www` ç®éå° `www` ç®é卿¨åååµå»ºçç§ç¾å¤ç¦å°æ¡çæ ¹ç®éã + +4. è¤è£½æè¦èåå§å°æ¡ä¸ç任使¬æ©è³ç¢ ( `Resources` ï¼çç.) + +5. è¤è£½ `config.xml` æªå° `www` ç®éä¸ï¼ä¸¦åªé¤ä»»ä½å¤æç¨å¼å®ç¾©ãæ¨éè¦ä¿®æ¹é裡çèä¸å¨å¹³èºç®éå §çè¨ç½®ã + +6. 使ç¨ç§ç¾å¤ç¦ CLI å·¥å ·ä¾å®è£æ¨éè¦çä»»ä½å¤æç¨å¼ãè«æ³¨æ CLI èçæææ ¸å¿ Api ä½çºå¤æç¨å¼ï¼æä»¥ä»åå¯è½éè¦æ·»å ãåªæ 3.0.0 夿ç¨å¼æ¯è CLI ç¸å®¹ã + +7. çæä¸¦æ¸¬è©¦ã + +## åç´ 2.8.0 å°æ¡å° 2.9.0 + +é»è 10ï¼ + +1. ä¸è¼ä¸¦è§£å£ç¸®å°æ¨ç硬ç¢ç£ç¢æ©ä¸çæ°¸ä¹ ç®éä½ç½®çç§ç¾å¤ç¦ 2.9.0 æºï¼ä¾å¦å°`~/Cordova-2.9.0`. + +2. éåºä»»ä½æ£å¨éè¡ç SDK å·¥å ·ï¼ æ¥é£ã Momentics åé¡ä¼¼ã + +3. å°èªå°æ¨æ¾å¨ä¸é¢ï¼ä½¿ç¨ç unix åçµç«¯çä¸è¼çæºçç®éï¼ çµç«¯ç¨å¼ï¼Bashï¼éåè»é«ï¼ççã + +4. åµå»ºä¸åæ°å°æ¡ï¼é»èææ©çå½ä»¤åå·¥å ·ä¸æè¿°ãéå°æçºæ¨æ´æ°çå°æ¡çå®¶ä¸ã + +5. å°æ¨çå°æ¡æºå¾èå°æ¡è¤è£½ `/www` å°æ°çå°æ¡ç®é `/www` ç®éã + +6. æ´æ°ä¸çç§ç¾å¤ç¦è ³æ¬å¼ç¨æ¨ `www/index.html` æª ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova.js` æªã + +çº BlackBerryOS/è¡åæåï¼ + +1. ä¸è¼ä¸¦è§£å£ç¸®å°æ¨ç硬ç¢ç£ç¢æ©ä¸çæ°¸ä¹ ç®éä½ç½®çç§ç¾å¤ç¦ 2.9.0 æºï¼ä¾å¦å°`~/Cordova-2.9.0`. + +2. éåºä»»ä½æ£å¨éè¡ç SDK å·¥å ·ï¼ æ¥é£ã Momentics åé¡ä¼¼ã + +3. å°èªå°æ¨æ¾å¨ä¸é¢ï¼ä½¿ç¨ç unix åçµç«¯çä¸è¼çæºçç®éï¼ çµç«¯ç¨å¼ï¼Bashï¼éåè»é«ï¼ççã + +4. åµå»ºä¸åæ°å°æ¡ï¼å¦ iOS å½ä»¤åå·¥å ·ä¸æè¿°ãæ¨éè¦å¾éåæ°çå°æ¡è³ç¢ã + +5. è¤è£½ `www/cordova.js` å°æ°å°æ¡ä¸çæªæ¨ `www` ç®éä¸ï¼ä¸¦åªé¤æ¨ `www/cordova.js` æªã + +6. æ´æ°ä¸çç§ç¾å¤ç¦è ³æ¬å¼ç¨æ¨ `www/index.html` æª ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova.js` æªã + +7. è¤è£½ `native` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `native` ç®éã + +8. è¤è£½ `lib` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `lib` ç®éã + +9. è¤è£½ `cordova` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `cordova` ç®éã + +## åç´ 2.7.0 å°æ¡å° 2.8.0 + +é»è 10 ä½¿ç¨æ°ç CLI æ¨¡å ·åç®¡çæ ¸å¿ä½çºå¤æç¨å¼ç Apiã 說æå°æ¨çå°æ¡é·ç§»å°æ°çå°æ¡ï¼è䏿¯æ´æ°ç¾æçå°æ¡ï¼ç±æ¼æ´æ°ä¸åèçå°æ¡çè¤éæ§ã æ¤å¤æ³¨æå°ç§ç¾å¤ç¦ js æä»¤æªç¾å¨è¢«ç¨±çº 'cordova.js' åä¸åå å«çæ¬çå串ã + +1. ä¸è¼ä¸¦è§£å£ç¸®å°æ¨ç硬ç¢ç£ç¢æ©ä¸çæ°¸ä¹ ç®éä½ç½®çç§ç¾å¤ç¦ 2.8.0 æºï¼ä¾å¦å°`~/Cordova-2.8.0`. + +2. éåºä»»ä½æ£å¨éè¡ç SDK å·¥å ·ï¼ æ¥é£ã Momentics åé¡ä¼¼ã + +3. å°èªå°æ¨æ¾å¨ä¸é¢ï¼ä½¿ç¨ç unix åçµç«¯çä¸è¼çæºçç®éï¼ çµç«¯ç¨å¼ï¼Bashï¼éåè»é«ï¼ççã + +4. åµå»ºä¸åæ°å°æ¡ï¼é»èææ©çå½ä»¤åå·¥å ·ä¸æè¿°ãéå°æçºæ¨æ´æ°çå°æ¡çå®¶ä¸ã + +5. å°æ¨çå°æ¡æºå¾èå°æ¡è¤è£½ `/www` å°æ°çå°æ¡ç®é `/www` ç®éã + +6. æ´æ°ä¸çç§ç¾å¤ç¦è ³æ¬å¼ç¨æ¨ `www/index.html` æª ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova.js` æªã + +çº BlackBerryOS/è¡åæåï¼ + +1. ä¸è¼ä¸¦è§£å£ç¸®å°æ¨ç硬ç¢ç£ç¢æ©ä¸çæ°¸ä¹ ç®éä½ç½®çç§ç¾å¤ç¦ 2.8.0 æºï¼ä¾å¦å°`~/Cordova-2.8.0`. + +2. éåºä»»ä½æ£å¨éè¡ç SDK å·¥å ·ï¼ æ¥é£ã Momentics åé¡ä¼¼ã + +3. å°èªå°æ¨æ¾å¨ä¸é¢ï¼ä½¿ç¨ç unix åçµç«¯çä¸è¼çæºçç®éï¼ çµç«¯ç¨å¼ï¼Bashï¼éåè»é«ï¼ççã + +4. åµå»ºä¸åæ°å°æ¡ï¼å¦ iOS å½ä»¤åå·¥å ·ä¸æè¿°ãæ¨éè¦å¾éåæ°çå°æ¡è³ç¢ã + +5. è¤è£½ `www/cordova.js` å°æ°å°æ¡ä¸çæªæ¨ `www` ç®éä¸ï¼ä¸¦åªé¤æ¨ `www/cordova.js` æªã + +6. æ´æ°ä¸çç§ç¾å¤ç¦è ³æ¬å¼ç¨æ¨ `www/index.html` æª ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova.js` æªã + +7. è¤è£½ `native` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `native` ç®éã + +8. è¤è£½ `lib` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `lib` ç®éã + +9. è¤è£½ `cordova` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `cordova` ç®éã + +## åç´ 2.6.0 å°æ¡å° 2.7.0 + +1. ä¸è¼ä¸¦è§£å£ç¸®å°æ¨ç硬ç¢ç£ç¢æ©ä¸çæ°¸ä¹ ç®éä½ç½®çç§ç¾å¤ç¦ 2.7.0 æºï¼ä¾å¦å°`~/Cordova-2.7.0`. + +2. éåºä»»ä½æ£å¨éè¡ç SDK å·¥å ·ï¼ æ¥é£ã Momentics åé¡ä¼¼ã + +3. å°èªå°æ¨æ¾å¨ä¸é¢ï¼ä½¿ç¨ç unix åçµç«¯çä¸è¼çæºçç®éï¼ çµç«¯ç¨å¼ï¼Bashï¼éåè»é«ï¼ççã + +4. åµå»ºä¸åæ°å°æ¡ï¼é»èææ©çå½ä»¤åå·¥å ·ä¸æè¿°ãæ¨éè¦å¾éåæ°çå°æ¡è³ç¢ã + +5. è¤è£½ `www/cordova-2.7.0.js` å°æ°å°æ¡ä¸çæªæ¨ `www` ç®éä¸ï¼ä¸¦åªé¤æ¨ `www/cordova-2.6.0.js` æªã + +6. æ´æ°ä¸çç§ç¾å¤ç¦è ³æ¬å¼ç¨æ¨ `www/index.html` æª ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova-2.7.0.js` æªã + +7. è¤è£½ `native` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `native` ç®éã + +8. è¤è£½ `lib` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `lib` ç®éã + +9. è¤è£½ `cordova` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èè徿°å°æ¡ç®é `cordova` ç®éã + +## å¾ 2.5.0 åç´å° 2.6.0 + +æ´æ° PhoneGap ä¸è¼ç®éï¼ + +建è°ä½ ä¸è¼æ´åç®éçæ°å¯æ¬ã + +使¯ï¼å¨é裡æ¯é¶æ²ç¢ææ´æ°æéçæ°é¶ä»¶ï¼ + +1. æ´æ°ä¸ç cordova.blackberry.js æª `Phonegap-2.6.0/lib/blackberry/javascript` ç®éã + +2. æ´æ° `ext` ï¼ `ext-air` ï¼å `ext-qnx` å¨ `Phonegap-2.6.0/lib/blackberry/framework` ç®éã + +3. æ´æ° `build.xml` æªå¨ `Phonegap-2.6.0/lib/blackberry` ç®éã + +4. æ´æ° `Phonegap-2.6.0/lib/blackberry/bin` ç®éã + +5. æ´æ° `VERSION` æªå¨ `Phonegap-2.6.0/lib/blackberry` ç®éã + +æ´æ°ç¤ºä¾ / ç®éæé·ç§»ç¾æçå°æ¡ï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `ext-qnx/` ç®éã + +5. è¤è£½æ° `cordova-2.6.0.js` å°æ¨çå°æ¡ã + +6. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.6.0.js` æªã + +## å¾ 2.4.0 åç´å° 2.5.0 + +æ´æ° PhoneGap ä¸è¼ç®éï¼ + +建è°ä½ ä¸è¼æ´åç®éçæ°å¯æ¬ã + +使¯ï¼å¨é裡æ¯é¶æ²ç¢ææ´æ°æéçæ°é¶ä»¶ï¼ + +1. æ´æ°ä¸ç cordova.blackberry.js æª `Phonegap-2.5.0/lib/blackberry/javascript` ç®éã + +2. æ´æ° `ext` ï¼ `ext-air` ï¼å `ext-qnx` å¨ `Phonegap-2.5.0/lib/blackberry/framework` ç®éã + +3. æ´æ° `build.xml` æªå¨ `Phonegap-2.5.0/lib/blackberry` ç®éã + +4. æ´æ° `Phonegap-2.5.0/lib/blackberry/bin` ç®éã + +5. æ´æ° `VERSION` æªå¨ `Phonegap-2.5.0/lib/blackberry` ç®éã + +æ´æ°ç¤ºä¾ / ç®éæé·ç§»ç¾æçå°æ¡ï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `ext-qnx/` ç®éã + +5. è¤è£½æ° `cordova-2.5.0.js` å°æ¨çå°æ¡ã + +6. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.5.0.js` æªã + +## å¾ 2.3.0 åç´å° 2.4.0 + +æ´æ°åªæ¯ `www` ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-2.4.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + * 妿é»è 10ï¼ç¶å¾æ´æ°ä¸ç.js æª `qnx/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.4.0.js` æªã + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.2.3.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.3.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.3.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js æª `cordova.2.3.0/javascript/` ç®éã + +6. æé `sample/lib/` ç®éåéå½å `cordova.2.3.0/` å°ç®é`cordova.2.4.0/`. + +7. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +8. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.4.0.js` æªã + +## å¾ 2.2.0 åç´å° 2.3.0 + +æ´æ°åªæ¯ `www` ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-2.3.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + * 妿é»è 10ï¼ç¶å¾æ´æ°ä¸ç.js æª `qnx/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.3.0.js` æªã + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.2.2.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.2.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.2.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js æª `cordova.2.2.0/javascript/` ç®éã + +6. æé `sample/lib/` ç®éåéå½å `cordova.2.2.0/` å°ç®é`cordova.2.3.0/`. + +7. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +8. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.3.0.js` æªã + +## å¾ 2.1.0 åç´å° 2.2.0 + +æ´æ°åªæ¯ www ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-2.2.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + * 妿é»è 10ï¼ç¶å¾æ´æ°ä¸ç.js æª `qnx/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.2.0.js` æªã + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.2.1.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.1.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.1.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js æª `cordova.2.1.0/javascript/` ç®éã + +6. æé `sample/lib/` ç®éåéå½å `cordova.2.1.0/` å°ç®é`cordova.2.2.0/`. + +7. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +8. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.2.0.js` æªã + +## å¾ 2.0.0 åç´å° 2.1.0 + +æ´æ°åªæ¯ `www` ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-2.1.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.1.0.js` æªã + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.2.0.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.0.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js æª `cordova.2.0.0/javascript/` ç®éã + +5. æé `sample/lib/` ç®éåéå½å `cordova.2.0.0/` å°ç®é`cordova.2.1.0/`. + +6. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +7. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.1.0.js` æªã + +## å¾ 1.9.0 åç´å° 2.0.0 + +æ´æ°åªæ¯ `www` ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-2.0.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.0.0.js` æªã + +6. æ´æ°æ¨ `www/plugins.xml` æªãå ©å夿ç¨å¼æ´æ¹å ¶å½å空é/æåæ¨ç±¤ãæ´æ¹çºçæç²åé£çµ¡äººç夿ç¨å¼ï¼å¾èçæ¢ç®ï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.media.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + èªï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.capture.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.1.9.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.1.9.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js æª `cordova.1.9.0/javascript/` ç®éã + +5. æé `sample/lib/` ç®éåéå½å `cordova.1.9.0/` å°ç®é`cordova.2.0.0/`. + +6. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +7. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-2.0.0.js` æªã + +8. æé `www/` ç®éåæ´æ° `plugins.xml` æªãå ©å夿ç¨å¼æ´æ¹å ¶å½å空é/æåæ¨ç±¤ãæ´æ¹çºçæç²åé£çµ¡äººç夿ç¨å¼ï¼å¾èçæ¢ç®ï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.media.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + èªï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.capture.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + +* è¦åç´å° 1.8.0ï¼è«è½å¾ 1.7.0 + +## å¾ 1.7.0 åç´å° 1.8.0 + +æ´æ°åªæ¯ `www` ç®éï¼ + +1. æéæ¨ `www/` ç®éï¼å ¶ä¸å 嫿¨çæç¨ç¨å¼ã + +2. åªé¤åæ´æ°ä¸ç.jar æª `ext/` ç®éã + +3. æ´æ°çå §å®¹ `ext-air/` ç®éã + +4. è¤è£½æ° `cordova-1.8.0.js` å°æ¨çå°æ¡ã + + * 妿è¡åæåï¼ç¶å¾æ´æ°.js æªå¨ `playbook/` ç®éã + +5. æ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-1.8.0.js` æªã + +6. æ´æ°æ¨ `www/plugins.xml` æªãå ©å夿ç¨å¼æ´æ¹å ¶å½å空é/æåæ¨ç±¤ãæ´æ¹çºçæç²åé£çµ¡äººç夿ç¨å¼ï¼å¾èçæ¢ç®ï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.media.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + èªï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.capture.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + +æ´æ° ï¼å³ï¼æ´æ°ä½¿ç¨ ant å·¥å ·ï¼ ç示ä¾ç®éï¼ + +1. æé `sample/lib/` ç®éã + +2. æ´æ°ä¸ç.jar æª `cordova.1.7.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.1.7.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js æª `cordova.1.7.0/javascript/` ç®éã + +5. æé `sample/lib/` ç®éåéå½å `cordova.1.7.0/` å°ç®é`cordova.1.8.0/`. + +6. é¡å `ant blackberry build` æ `ant playbook build` 便´æ° `www/` ç®éèæ´æ°ç§ç¾å¤ç¦ã + +7. æé `www/` ç®éåæ´æ°æ¨ç html 代碼ï¼ä½¿ç¨æ°ç `cordova-1.8.0.js` æªã + +8. æé `www/` ç®éåæ´æ° `plugins.xml` æªãå ©å夿ç¨å¼æ´æ¹å ¶å½å空é/æåæ¨ç±¤ãæ´æ¹çºçæç²åé£çµ¡äººç夿ç¨å¼ï¼å¾èçæ¢ç®ï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.media.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > + + èªï¼ + + < 夿ç¨å¼å稱 ="æç²"value="org.apache.cordova.capture.MediaCapture"/ >< 夿ç¨å¼å稱 ="é£çµ¡äºº"value="org.apache.cordova.pim.Contact"/ > \ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/firefoxos/config.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/firefoxos/config.md b/www/docs/zh-cn/6.x/guide/platforms/firefoxos/config.md new file mode 100644 index 0000000..b56a61b --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/firefoxos/config.md @@ -0,0 +1,23 @@ +--- +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: FirefoxOS é ç½® +--- + +# FirefoxOS é ç½® \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/firefoxos/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/firefoxos/index.md b/www/docs/zh-cn/6.x/guide/platforms/firefoxos/index.md new file mode 100644 index 0000000..4f75845 --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/firefoxos/index.md @@ -0,0 +1,95 @@ +--- +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: ç«çç覽å¨ä½æ¥ç³»çµ±å¹³èºæå +--- + +# ç«çç覽å¨ä½æ¥ç³»çµ±å¹³èºæå + +æ¬æåä»ç´¹äºå¦ä½è¨ç½®æ¨çéç¼ç°å¢åµå»ºç§ç¾å¤ç¦æç¨ç¨å¼çºç«ç OS çè¨åï¼ç¶å¾æ¸¬è©¦åç¼ä½éäºæç¨ç¨å¼ã + +## è¦æ±åæ¯æ´ + +ç«çç覽å¨ä½æ¥ç³»çµ±çæç¨ç¨å¼ï¼åºæ¬ä¸åªæ¯çº web æç¨ç¨å¼ï¼å ä¸ä¸å manifest.webapp æªï¼å®ç¾©äºæéæç¨ç¨å¼çä¸ç¹¼è³æï¼ä¸¦å 許å®å¨ç«çç覽å¨ä½æ¥ç³»çµ±çè¨åä¸å®è£ã å¯ä»¥ä½¿ç¨ä»»ä½ç§ç¾å¤ç¦æ¯æ´çå¹³èºãè¦æ¾åºæéæ§å»º web æç¨ç¨å¼ç詳細è³è¨ï¼è«è«®è©¢ä¸[åèª][1]ç[App ä¸å¿][2]. + + [1]: https://developer.mozilla.org/en-US/ + [2]: https://developer.mozilla.org/en-US/Apps + +## å®è£åç°å¢è¨ç½® + +ç¬¬ä¸æ¬¡å®è£[Node.js][3]ï¼ç¶å¾å®è£ç§ç¾å¤ç¦å å°±å鿍£ï¼ + + [3]: http://nodejs.org/ + + $ npm install -g cordova + + +æ¥ä¸ä¾ï¼åµå»ºä¸å示ä¾ç§ç¾å¤ç¦æç¨ç¨å¼ï¼ç¶å¾å°èªå°æ°åµå»ºçç®éï¼ + + $ cordova create test-app + $ cd test-app + + +ç«çç覽å¨ä½æ¥ç³»çµ±ä½çºåæ¯æ´çå¹³èºæ·»å å°å¨ä»¥ä¸æç¨ç¨å¼ï¼ + + $ cordova platform add firefoxos + + +éå°åµå»ºä¸åç«ççè¦½å¨æä½ç³»çµ±æç¨ç¨å¼å¹³èº/firefoxos/www ç®éï¼ç®åçèµ·ä¾é½ä¸æ¨£é¤äºï¼å®å·²å¨ www ç®éçç«çç覽å¨çæ¸ å®æª (manifest.webapp) ä¸ã + +## éç¼æ¨çæç¨ç¨å¼ + +æ¤æä½ æºåå¥½å» â â æ¸¬è©¦-app/www 裡é¢çä»£ç¢¼æ´æ¹çºä»»ä½ä½ æ³è¦æ¨çæç¨ç¨å¼æã ä½ å¯ä»¥åæç¨ç¨å¼ï¼ä¾å¦ä½¿ç¨"ç§ç¾å¤ç¦å¤æç¨å¼æ·»å "ï¼æ·»å [æ¯æ´ç夿ç¨å¼]()ï¼ + + cordova plugin add cordova-plugin-device + cordova plugin add cordova-plugin-vibration + + +ç¶ç·¨å¯«æç¨ç¨å¼ä»£ç¢¼æï¼å°æ¨çæ´æ¹é¨ç½²å°æ¨å·²ç¶æ·»å å°æ¨çå°æ¡èç«ççè¦½å¨æä½ç³»çµ±æç¨ç¨å¼ + + $ cordova prepare firefoxos + + +è¥è¦åµå»ºä¸åæå çæç¨ç¨å¼ä¹ä¸å¯ä»¥éµç·¨å¹³èº/firefoxos/www ç®éãç°¡å®å°ä¹å¯ä»¥çæä½¿ç¨ + + $ cordova build firefoxos + + +ç«çç覽å¨ä½æ¥ç³»çµ±å°è£çæç¨ç¨å¼å°å¨ platforms/firefoxos/build/package.zip 建æ + +## 測試å調試 + +å¯ä»¥ä½¿ç¨ç«çç覽å¨ä½æ¥ç³»çµ± [Web IDE][4] 測試æç¨ç¨å¼. + + [4]: https://developer.mozilla.org/en-US/docs/Tools/WebIDE + +ç¶æ¨å·²é£æ¥å°æ¨ç測試è¨å/模æ¬å¨ Web IDE æï¼è«é¸æ"æéæå æç¨ç¨å¼"é¸é ï¼ç¶å¾ç¢ºä¿æ¨æå測試-app/platforms/firefoxos/www/ç®éè¦å¨ Manager ä»é¢ä¸å å«è©²æç¨ç¨å¼ã + +å¨éè£¡ä½ å¯ä»¥å¨ä½ 測試è¨å/模æ¬å¨ ï¼è"ææ¾"æéï¼ ä¸å®è£æç¨ç¨å¼ã使ç¨"æ«å"æéï¼ç¶å¾å¯ä»¥èª¿è©¦æç¨ç¨å¼ä¸¦ç·¨è¼¯å®çä»£ç¢¼çæ´»ã + +注æï¼ è¦ç¼ä½æ¨çæç¨ç¨å¼å¨å試ä¹åä½ æè©²èæ ®é©èå®å¯ä»¥ä½¿ç¨ [æç¨ç¨å¼é©èç¨å¼][5]. + + [5]: https://marketplace.firefox.com/developers/validator + +## ç¼ä½æ¨çæç¨ç¨å¼å°ç«çç覽å¨å¸å ´ + +æ¨å¯ä»¥æäº¤æ¨çæç¨ç¨å¼å°ç«çç覽å¨å¸å ´çéæ±ï¼æç¼ä½å®èªå·±ã [ç«çç覽å¨å¸å ´å][6] æè¨ª MDN ä¾çè§£æ´å¤æéå¦ä½åå°éä¸é» ï¼[æç¨ç¨å¼ç¼ä½é¸é ][7] æ¯æä½³çå°æ¹éå§ã + + [6]: https://developer.mozilla.org/en-US/Marketplace + [7]: https://developer.mozilla.org/en-US/Marketplace/Publishing/Publish_options \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/index.md b/www/docs/zh-cn/6.x/guide/platforms/index.md new file mode 100644 index 0000000..31e7b0f --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/index.md @@ -0,0 +1,87 @@ +--- +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: å¹³èºæå +--- + +# å¹³èºæå + +å¨éç¼ä¹åçºä»»ä½ä¸é¢ååºçå¹³èºï¼å®è£ç§ç¾å¤ç¦çå½ä»¤åä»é¢ (CLI)ãï¼æé詳細è³è¨ï¼è¦å½ä»¤åä»é¢ï¼ã + +è¦éç¼ç§ç¾å¤ç¦çæç¨ç¨å¼ï¼æ¨å¿ é çºæ¨çç®æ¨æ¯åç§»åå¹³èºå®è£ Sdkã é種å®è£æ¯å·¥ä½çå¿ è¦ç¡è«ä½ åä½ å¨ SDK ä¸å¤æ¸éæ¯çºæ¨çµå»ºå¾ªç°ä½¿ç¨ CLI çã + +ä¸é¢ååºæ¯å*å¹³èºæå*åè¨´æ¨æ¨éè¦ç¥éè¦è¨ç½®çæ¯åå¹³èºçéç¼ç°å¢ï¼ å¨ä½èç²å SDKã å¦ä½è¨ç½®è¨å模æ¬ç¨å¼ã å¦ä½é£æ¥è¨åé²è¡ç´æ¥æ¸¬è©¦åå¦ä½ç®¡ç簽署çééµè¦æ±ã éå æåæä¾äºæ¯åå¹³èºç¹æçé ç½®é¸é ï¼èªªææ·»å 夿ç¨å¼ï¼è³è¨å¦ä½åç´æ¯åå¹³èºï¼ä»¥åç¹å®äºå¹³èºçå½ä»¤åå·¥å ·ï¼ä½çºä¸åè¼ä½ç´å¥çæ¿ä»£ `cordova` å½ä»¤å實ç¨ç¨å¼ã + +## äºé¦¬éç« OS + +* [äºé¦¬éç« OS å¹³èºæå](amazonfireos/index.html) +* [äºé¦¬éç« OS é ç½®](amazonfireos/config.html) +* [äºé¦¬éç« OS WebViews](amazonfireos/webview.html) +* [äºé¦¬éç« OS 夿ç¨å¼](amazonfireos/plugin.html) + +## Android 系統 + +* [Android å¹³èºæå](android/index.html) +* [Android æ®¼å·¥å ·æå](android/tools.html) +* [Android ç³»çµ±çµæ ](android/config.html) +* [Android 夿ç¨å¼](android/plugin.html) +* [Android WebViews](android/webview.html) +* [åç´ Android](android/upgrading.html) + +## é»è 10 + +* [10 é»èå¹³èºæå](blackberry10/index.html) +* [é»è 10 ææ©æ®¼å·¥å ·æå](blackberry10/tools.html) +* [é»è 10 é ç½®](blackberry10/config.html) +* [é»è 10 夿ç¨å¼](blackberry10/plugin.html) +* [åç´é»è 10](blackberry10/upgrading.html) + +## ç«çç覽å¨ä½æ¥ç³»çµ± + +* [ç«çç覽å¨ä½æ¥ç³»çµ±å¹³èºæå](firefoxos/index.html) + +## iOS + +* [iOS å¹³èºæå](ios/index.html) +* [iOS æ®¼å·¥å ·æå](ios/tools.html) +* [iOS é ç½®](ios/config.html) +* [iOS 夿ç¨å¼](ios/plugin.html) +* [WebViews iOS](ios/webview.html) +* [åç´ iOS](ios/upgrading.html) + +## Ubuntu + +* [Ubuntu å¹³èºæå](ubuntu/index.html) + +## Windows Phone 8 + +* [Windows Phone 8 å¹³èºæå](wp8/index.html) +* [Windows Phone 8 夿ç¨å¼](wp8/plugin.html) +* [åç´ Windows Phone 8](wp8/upgrade.html) + +## Windows + +* [Windows å¹³èºæå](win8/index.html) +* [Windows 夿ç¨å¼](win8/plugin.html) +* [Windows å è£](win8/packaging.html) +* [åç´ Windows 8](win8/upgrading.html) + +## Tizen + +* [Tizen å¹³èºæå](tizen/index.html) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/ios/config.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/ios/config.md b/www/docs/zh-cn/6.x/guide/platforms/ios/config.md new file mode 100644 index 0000000..8cdda84 --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/ios/config.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: iOS é ç½® +--- + +# iOS é ç½® + +`config.xml`æªæ§å¶æç¨æ¼æ¯åæç¨ç¨å¼å CordovaWebView 實ä¾çæç¨ç¨å¼çåºæ¬è¨ç½®ã æ¬ç¯è©³ç´°èªªæå é©ç¨äº iOS çæ¬çé¦é¸é ã æéå ¨åé ç½®é¸é çè³è¨ï¼è«åé± [config.xml æª][1]ã + + [1]: config_ref_index.md.html#The%20config.xml%20File + +* `EnableViewportScale`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` ï¼ä»¥ä¾¿è¦åå æ¨è¨ä¾ç¦ç¨æéå¶çç¯åç使ç¨è æ¯ä¾ï¼éé è¨åç¨çã + + <preference name="EnableViewportScale" value="true"/> + + + æ¾ç½®å¨ HTML ä¸ç¦ç¨ç¸®æ¾åé©åçè¦å£ï¼å¦ä¸å §å®¹éæ´»å°å §åç¾ web è¦åï¼ + + <meta name='viewport' content='width=device-width, initial-scale=1, user-scalable=no' /> + + +* `MediaPlaybackAllowsAirPlay`(é è¨çº`true`ç叿å¼): è¨ç½®çº`false` ï¼ä»¥é²æ¢ç©ºæ°£ç¼æ®è¢«ä½¿ç¨å¨æ¤è¦åä¸ã å¨é è¨ UIWebView å WKWebView ä¸å¯ç¨ã + + <preference name="MediaPlaybackAllowsAirPlay" value="false"/> + + +* `MediaPlaybackRequiresUserAction`(é è¨çº`false`ç叿å¼): è¨ç½®çº`true`以鲿¢èªåææ¾`èªåææ¾`å±¬æ§æéé JavaScript HTML5 è¦é »æé³è¨ã + + <preference name="MediaPlaybackRequiresUserAction" value="true"/> + + +* `AllowInlineMediaPlayback`(é è¨çº`false`ç叿å¼): è¨ç½®çº`true` ï¼å 許 HTML5 åªé«éæé¡¯ç¤º*å §è¯*å¨è¢å¹ä½å±ï¼ä½¿ç¨çè¦½å¨æä¾çæ§å¶é ï¼è䏿¯æ¬æ©æ§å¶é å §ã éé å·¥ä½ï¼å°æ·»å å°ä»»ä½`< video >`å ç´ ç`webkit playsinline`屬æ§ã + + <preference name="AllowInlineMediaPlayback" value="true"/> + + +* `BackupWebStorage`(å串ï¼è¦éº¼`none`ï¼`local`ï¼æé è¨`é²`): è¨ç½®çº`cloud`以å 許éé iCloud å份 web åå²è³æã è¨ç½®çº`local`以å è¨±åªææ¬å°å份éé iTunes 忥ã è¨ç½®çº`none`鲿¢ web åå²å份ã + + <preference name="BackupWebStorage" value="local"/> + + +* `TopActivityIndicator`(å串ï¼é è¨çº`gray`): æ§å¶çæ åæç¤ºå¤§éçèç卿´»å䏿è½çå°å示çå¤è§ã ææå¼çº`whiteLarge`ã`white`å`gray`. + + <preference name="TopActivityIndicator" value="white"/> + + +* `KeyboardDisplayRequiresUserAction`(é è¨çº`true`ç叿å¼): è¨ç½®çº`false`以å 許éµç¤é¡¯ç¤ºè¡¨å®è¼¸å ¥èª¿ç¨`focus ()`æã + + <preference name="KeyboardDisplayRequiresUserAction" value="false"/> + + +* `SuppressesIncrementalRendering`(é è¨çº`false`ç叿å¼): è¨ç½®çº`true` ï¼çå¾ ï¼ç´å°å¨åç¾å°è¢å¹ä¹åå·²æ¶å°çææå §å®¹ã + + <preference name="SuppressesIncrementalRendering" value="true"/> + + +* `GapBetweenPages`(æµ®åï¼é è¨å¼çº``): ç大å°ï¼ä»¥ç£ çºå®ä½ï¼é é¢ä¹éçå·®è·ã + + <preference name="GapBetweenPages" value="0"/> + + +* `PageLength`(æµ®åï¼é è¨å¼çº``): æ¯åé é¢ï¼å¨é 颿µçæ¹åé»ç大å°ã ç¶ PaginationMode æ¯å¾å³è³å·¦æå¾å·¦è³å³ï¼æ¤å±¬æ§å·¥ä½è¡¨ç¤ºæ¯åé é¢ç寬度ã ç¶ PaginationMode æ¯ topToBottom æ bottomToTop æï¼æ¤å±¬æ§å·¥ä½è¡¨ç¤ºæ¯åé é¢çé«åº¦ã é è¨å¼çº 0ï¼éæå³èä½å±ä½¿ç¨è¦åç大å°ä¾ç¢ºå®é é¢ç大å°ã + + <preference name="PageLength" value="0"/> + + +* `PaginationBreakingMode`(å串ï¼é è¨çº`é é¢`): ææå¼çº`é `å`å`ãå¨åæé ç ´ç¼ççæ¹å¼ã æ¤å±¬æ§ç¢ºå®æ¯å¦æäº CSS 屬æ§éæ¼ååé ç ´æ¯æ¦®å¹¸éæ¯å¿½ç¥ã ç¶æ¤å±¬æ§è¨ç½®çº`å`æï¼å §å®¹æ¹é¢èå°ä½çé ç ´æ·åç¸éç CSS 屬æ§ã + + <preference name="PaginationBreakingMode" value="page"/> + + +* `PaginationMode`(å串ï¼é è¨çº`unpaginated`): ææå¼çº`unpaginated`ï¼ `leftToRight`ã `topToBottom`ã `bottomToTop`å`rightToLeft`ã æ¤å±¬æ§å¯ç¢ºå®æ¯å¦å¨ web è¦åä¸çå §å®¹åè§£æé é¢å ¨å±é¡¯ç¤ºè¦å䏿¬¡ï¼æä¸åé·ç滾åè¦åæç¤ºã 妿è¨ç½®çºåé ç表å®ï¼æ¤å±¬æ§åæåé çä½å±çå §å®¹ï¼å ¶å §å®¹é æ web è¦å使ç¨å ´å°ç PageLength å GapBetweenPages çå¼ã + + <preference name="PaginationMode" value="unpaginated"/> + + +* `UIWebViewDecelerationSpeed`(å串ï¼é è¨çº`normal`): ææçå¼é½æ¯`normal`ï¼`fast`ã æ¤å±¬æ§æ§å¶æ¸éçå¢é 滾åã å°æ¼å¤§å¤æ¸æ¬æ©æç¨ç¨å¼çé è¨é度æ¯`normal`å`fast`æ¯ç§»å Safari çé è¨å¼ã + + <preference name="UIWebViewDecelerationSpeed" value="fast" /> + + +* `ErrorUrl`(å串ï¼é è¨æ æ³ä¸æªè¨ç½®): 妿è¨ç½®ï¼å°é¡¯ç¤ºå¨æç¨ç¨å¼ä¸åºç¾é¯èª¤ææå¼ç¨çæ¬å°ç¶²é ã + + <preference name="ErrorUrl" value="myErrorPage.html"/> + + +* `OverrideUserAgent`(å串ï¼é è¨æ æ³ä¸æªè¨ç½®): 妿è¨ç½®ï¼å¼å°æ¿æè使ç¨è 代çç web è¦åã 宿婿¼å¾æç¨ç¨å¼æç覽å¨è«æ±æè«æ±é 端é é¢ï¼èå¥ã ä½¿ç¨æè¬¹æ æ 度ï¼éå¯è½å°è´è web 伺æå¨ç compitiable åé¡ã å°æ¼å¤§å¤æ¸æ æ³ä¸ï¼æ¹ç¨ AppendUserAgentã + + <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" /> + + +* `AppendUserAgent`(å串ï¼é è¨æ æ³ä¸æªè¨ç½®): 妿è¨ç½®ï¼å¼å°éå å°å¹´åºè使ç¨è 代çç web è¦åã ç¶ä½¿ç¨ OverrideUserAgentï¼æ¤å¼å°è¢«å¿½ç¥ã + + <preference name="AppendUserAgent" value="My Browser" /> http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/ios/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/ios/index.md b/www/docs/zh-cn/6.x/guide/platforms/ios/index.md new file mode 100644 index 0000000..245c36d --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/ios/index.md @@ -0,0 +1,218 @@ +--- +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: iOS å¹³èºæå +--- + +# iOS å¹³èºæå + +æ¬æåä»ç´¹å¦ä½è¨ç½®æ¨ç SDK éç¼ç°å¢é¨ç½²ç§ç¾å¤ç¦ç iOS è¨å ï¼å¦ iPhone å iPad çæç¨ç¨å¼ãè«åé±ä¸åç¹å®äºå¹³èºç詳細è³è¨ï¼ + +* [iOS é ç½®](config.html) +* [åç´ iOS](upgrading.html) +* [WebViews iOS](webview.html) +* [iOS 夿ç¨å¼](plugin.html) +* [iOS æ®¼å·¥å ·æå](tools.html) + +ä¸é¢çå½ä»¤åå·¥å ·è«åé±ç§ç¾å¤ç¦ 3.0 以åççæ¬ãéæ¼ç¶åä»é¢çè³è¨ï¼è«åé±å½ä»¤åä»é¢ã + +## è¦æ±åæ¯æ´ + +èæå ¬å¸ ® çæå å¨åºæ¼è±ç¹ç¾ç Mac OS X 使¥ç³»çµ±ä¸éè¡ç iOS æç¨ç¨å¼æéçå·¥å ·ã å å¨ OS X çæ¬ 10.9 ï¼å°çï¼ ä¸éè¡ Xcode ® 6.0 ï¼æéçæä½çæ¬ï¼ ææ´é«çæ¬ï¼ä¸¦å å« iOS 8 SDK ï¼è»é«ç¼å±å·¥å ·çµï¼ã è¦æäº¤å°èæ App Storeâ çæç¨ç¨å¼éè¦çèæå·¥å ·çææ°çæ¬ã + +æ¨å¯ä»¥æ¸¬è©¦ç許å¤ç§ç¾å¤ç¦åè½ä½¿ç¨ iOS 模æ¬å¨å®è£ ios SDK å Xcodeï¼ä½ä½ éè¦ä½¿ç¨å¯¦éçè¨åå®å ¨æäº¤å° App Store ä¹åæ¸¬è©¦çæææç¨ç¨å¼çè£ç½®åè½ã 該è¨åå¿ é è³å°æ iOS è£æ 6.xã å°ç§ç¾å¤ç¦ 3.0 æ¯æ´çæä½ç iOS çæ¬ãé å¥è¨åå æ¬ææ iPad ® 模åã iPhone ® 3GS 以ä¸ï¼å iPod ® 觸æ¸ç¬¬ä¸ä»£ææ´é«çæ¬ã è¦å®è£å°è¨åä¸çæç¨ç¨å¼ï¼æ¨å¿ é 乿¯èæå ¬å¸ç[iOS éç¼è è¨ç«][1]ï¼è©²è²»ç¨æ¯ 99 å¹´ç¾å çæå¡ã æ¬æåæ¼ç¤ºå¦ä½å°æç¨ç¨å¼é¨ç½²å° iOS 模æ¬å¨ï¼ä¸å¿ 註åéç¼è è¨ç«ã + + [1]: https://developer.apple.com/programs/ios/ + +[Ios sim å¡][2]å[ios-deploy][3]å·¥å ·å 許æ¨ååå° iOS 模æ¬å¨ç iOS æç¨ç¨å¼ä¸¦å¾å½ä»¤åç iOS è¨åã + + [2]: https://www.npmjs.org/package/ios-sim + [3]: https://www.npmjs.org/package/ios-deploy + +## å®è£ SDK + +æå ©ç¨®æ¹å¼ä¸è¼ Xcodeï¼ + +* å¾[æç¨ç¨å¼ååº][4]ï¼å¯ééæç´¢"Xcode"å¨**App Store**ä¸çæç¨ã + +* å¾[èæéç¼è ä¸è¼][5]ï¼èä½çºèæéç¼è éè¦è¨»åã + + [4]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12 + [5]: https://developer.apple.com/downloads/index.action + +䏿¦å®è£äº Xcodeï¼å¹¾åå½ä»¤åå·¥å ·éè¦çºç§ç¾å¤ç¦éè¡åç¨ã å¾**Xcode**åè½è¡¨ä¸ï¼é¸æ**é¦é¸é **ï¼ç¶å¾**ä¸è¼**é¸é å¡ã å¾**å ä»¶**颿¿ä¸ï¼æ**å½ä»¤åå·¥å ·**æ¸ å®æéç**å®è£**æéã + +## å®è£é¨ç½²å·¥å · + +徿®éåç·è·¯çµç«¯ä¸éè¡ï¼ + + $ npm install -g ios-sim + $ npm install -g ios-deploy + + +## åµå»ºä¸åæ°çå°æ¡ + +使ç¨`ç§ç¾å¤ç¦`實ç¨ç¨å¼è¨ç½®äºä¸åæ°çå°æ¡ï¼å¦æè¿°å¨ç§ç¾å¤ç¦çå½ä»¤åä»é¢ãä¾å¦ï¼å¨ä¸ååå§ç¨å¼ç¢¼ç®éï¼ + + $ cordova create hello com.example.hello "HelloWorld" + $ cd hello + $ cordova platform add ios + $ cordova prepare # or "cordova build" + + +## é¨ç½²æç¨ç¨å¼ + +è¦é¨ç½²çæç¨ç¨å¼é£æ¥ç iOS è¨åä¸ï¼ + + $ cordova run ios --device + + +é¨ç½²é è¨ iOS 模æ¬å¨ä¸çæç¨ç¨å¼ï¼ + + $ cordova emulate ios + + +æ¨å¯ä»¥ä½¿ç¨**cordova run ios --list**çå°ææå¯ç¨çç®æ¨å**cordova run ios --target=target_name**å¨ä¸åç¹å®çè¨åææ¨¡æ¬å¨ä¸éè¡æç¨ç¨å¼ ï¼ä¾å¦ï¼`cordova run ios --target="iPhone-6"`). + +æ¨éå¯ä»¥ä½¿ç¨**ç§ç¾å¤ç¦éè¡ â â 説æ**æ¥çéå ççæåéè¡é¸é ã + +## å¨ SDK 䏿éå°æ¡ + +䏿¦ ios å¹³èºæ·»å å°å°æ¡ä¸ï¼æ¨å¯ä»¥æéå®å¾å § Xcodeãæå ©ä¸ä»¥æé`hello/platforms/ios/hello.xcodeproj`æªãè¢å¹æè©²å¦ä¸æç¤ºï¼ + +![][6] + + [6]: {{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png + +## é¨ç½²å°æ¨¡æ¬ç¨å¼ + +è¥è¦é è¦½å¨ iOS 模æ¬å¨ä¸çæç¨ç¨å¼ï¼ + +1. è«ç¢ºä¿å¨å·¦éç颿¿ä¸é¸æ*.xcodeproj*æªã + +2. 鏿**ä½ å¥½**app ç«å³åå³é¢æ¿ä¸ã + +3. å¾å·¥å ·åä¸ç**è¨ç«**åè½è¡¨ä¸é¸æé å®çè¨åã iPhone çä½çº 6.0 模æ¬å¨å¨é裡çªåºäºï¼ + + ![][7] + +4. æä¸**éè¡**æéåºç¾å¨åä¸å·¥å ·åå·¦å´ç**è¨ç«**ä¸ã é£çæã é¨ç½²ä¸¦å¨æ¨¡æ¬å¨ä¸éè¡æç¨ç¨å¼ã ä¸åå®ç¨ç模æ¬å¨æç¨ç¨å¼å°æéï¼ä¸¦é¡¯ç¤ºè©²æç¨ç¨å¼ï¼ + + ![][8] + + åªæä¸å模æ¬ç¨å¼å¯è½æéè¡ä¸æ¬¡ï¼æä»¥å¦æä½ æ³è¦å¨ä¸åçæ¨¡æ¬å¨ä¸æ¸¬è©¦æç¨ç¨å¼ï¼æ¨éè¦éåºç模æ¬ç¨å¼æç¨ç¨å¼åéè¡ä¸åä¸åçç®æ¨å¨ Xcode çç¯åå §ã + + [7]: {{ site.baseurl }}/static/img/guide/platforms/ios/select_xcode_scheme.png + [8]: {{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png + +Xcode æç¶èææ°çæ¬ç iPhone å iPad çæ¨¡æ¬å¨ã èçæ¬ä¹è¨±å¯ä»¥å¾**Xcode â é¦é¸é â ä¸è¼ â å ä»¶**颿¿ã + +## å°é¨ç½²å°è¨å + +éæ¼åé è¦æ±é¨ç½²å°ä¸åè¨åç詳細è³è¨ï¼è«åé±èæå ¬å¸[éæ¼æç¨ç¨å¼åé 工使µ][9]ç*å忍çæç¨ç¨å¼å°è¨å*é¨åã ç°¡å®å°èªªï¼æ¨éè¦é¨ç½²ä¹åå·è¡ä»¥ä¸æä½ï¼ + + [9]: https://developer.apple.com/library/prerelease/ios/documentation/IDEs/Conceptual/AppDistributionGuide/Introduction/Introduction.html + +1. å å ¥èæ iOS éç¼è è¨ç«ã + +2. åµå»º*è³æºèª¿é è¨å®æª*å §[iOS è³æºèª¿é éæ¶][10]ã æ¨å¯ä»¥ä½¿ç¨å ¶*ç¼å±è³æºèª¿é å©ç*ä¾åµå»ºåå®è£è¨å®æªåèæ¸ Xcode éè¦ã + +3. é©è*代碼簽å*é¨å*ä»£ç¢¼ç°½åæ¨è*å §çå°æ¡è¨ç½®è¨ç½®çºæ¨è¨ç½®çè¨å®æªå稱ã + + [10]: https://developer.apple.com/ios/manage/overview/index.action + +è¦é¨ç½²å°è¨åï¼ + +1. ä½¿ç¨ USB é»çºå°è¨åæå ¥å°æ¨ç macã + +2. Xcode è¦çª**è¨ç«**ä¸ææ¸ å®ä¸é¸æçå°æ¡çå稱ã + +3. å¾**è¨å**ä¸ææ¸ å®ä¸é¸ææ¨çè¨åã妿å®éé USB 飿¥é»æºï¼ä½ä»ç¶æ²æåºç¾ï¼è«æ**管çå¨**æéï¼ä»¥è§£æ±ºä»»ä½é¯èª¤ã + +4. æä¸**éè¡**æé以çæã é¨ç½²ä¸¦éè¡è©²æç¨ç¨å¼å¨æ¨çè¨åä¸ã + +## 常è¦çåé¡ + +**妿±ºè¦å**ï¼ ç¶æç¨ç¨å¼æ´æ¹ææ¿æçºå¦ä¸å API ç¨å¼è¨è¨ä»é¢ (API) æï¼å®è¢«æ¨è¨çº*å·²æ£ç¨*ã 該 API ä»å¯å·¥ä½å¨çæå §ï¼ä½æçµå°è¢«åªé¤ã ä¸äºéäºéæçä»é¢ï¼åæ å¨ Apache ç§ç¾å¤ç¦å Xcode åé¡éæ¼ä»åçè¦åï¼ç¶æ¨çæåé¨ç½²æç¨ç¨å¼ã + +`InvokeString`æ¹æ³ Xcode çè¦åæéååä¸åæç¨ç¨å¼å¾ä¸åèªè¨ç URL çåè½ã éç¶å¾ä¸åèªè¨ç URL è¼å ¥çæ©å¶ç¼çäºæ¹è®ï¼æ¤ä»£ç¢¼æ¯ä»ç¶åå¨ï¼ä»¥ä¾¿çºç§ç¾å¤ç¦çè¼æ©çæ¬åµå»ºçæç¨ç¨å¼æä¾åå¾çåè½ã æç¨ç¨å¼ç¯ä¾ä¸ä½¿ç¨æ¤åè½ï¼å æ¤å¯ä»¥å¿½ç¥éäºè¦åã è¥è¦é²æ¢åºç¾éäºè¦åï¼è«ç§»é¤å¼ç¨å·²æ£ç¨ç invokeString API çä»£ç¢¼ï¼ + +* 編輯*Classes/MainViewController.m*æªã ç°ç¹ç代碼èä¸é¢çå¡ `/*` å `*/` çè©è«å¦ä¸æç¤ºï¼ç¶å¾éµå ¥**å½ä»¤-s**ä¿å該æªï¼ + + (void)webViewDidFinishLoad:(UIWebView*)theWebView + { + // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle + /* + if (self.invokeString) { + // this is passed before the deviceready event is fired, so you can access it in js when you receive deviceready + NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url."); + NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString]; + [theWebView stringByEvaluatingJavaScriptFromString:jsString]; + } + */ + // Black base color for background matches the native apps + theWebView.backgroundColor = [UIColor blackColor]; + + return [super webViewDidFinishLoad:theWebView]; + } + + +* 編輯*Classes/AppViewDelegate.m*æªï¼æ³¨éæä¸é¢çè¡æå ¥éææ ï¼å¦ä¸æç¤ºï¼ç¶å¾éµå ¥**å½ä»¤-s**ä¿å該æªï¼ + + //self.viewController.invokeString = invokeString; + + +* æ**å½ä»¤-b**éæ°çæå°æ¡ä¸¦æ¶é¤æ¤è¦åã + +<!-- Does this fix only last until the next "cordova prepare"? --> + +**ç¼ºå°æ¨é¡**ï¼ æéå¤±è¹¤çæ¨é çç·¨è¯é¯èª¤å°è´å¾çæä½ç½®çåé¡ï¼å¯ä»¥éé Xcode å好åºå®ï¼ + +1. 鏿**Xcode â é¦é¸é â ä½ç½®**. + +2. å¨**æ´¾ççè³æ**é¨åä¸ï¼æ**é«ç´**æé䏦鏿**å¯ä¸**ä½çº**çæä½ç½®**å¦ä¸æç¤ºï¼ + + ![][11] + + [11]: {{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png + +鿝ä¸åæ°ç Xcode å®è£çé è¨è¨ç½®ï¼ä½å¯ä»¥è¨ç½®ä¸åçåç´ä¹å¾å¾ Xcode èçæ¬ã + +é²ä¸æ¥çè³è¨ï¼è«åé±èæçææªï¼ + +* [éå§éç¼ iOS æç¨ç¨å¼ä»å¤©][12]å¿«éæ¦è¿°çæ¥é©éç¼ iOS çæç¨ç¨å¼ã + +* [æå¡ä¸å¿ä¸»é ][13]æä¾å¹¾å iOS çé£çµæè¡è³æºå æ¬æè¡è³æºï¼è³æºèª¿é éæ¶ã å使åå社åè«å£ã + +* [IOS å·¥å ·å·¥ä½æµæå][14] + +* [Xcode 使ç¨è æå][15] + +* å¾èæä¸ç廣æ³éç¼äººå¡æè° (WWDC2012) 2012å¹´[屿è°è¦é »][16] + +* å®è£[xcode 鏿å½ä»¤][17]ï¼å®æå©æ¼æå®æ£ç¢ºçæ¬ç Xcodeï¼å¦æä¸æ¢ä¸åç話ã + + [12]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343 + [13]: https://developer.apple.com/membercenter/index.action + [14]: http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959 + [15]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215 + [16]: https://developer.apple.com/videos/wwdc/2012/ + [17]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html + +ï¼Mac ® OS X ® Xcode ® èæ Â® çæç¨ç¨å¼é²è¡ï¼iPad ®ï¼iPhone ®ï¼iPod ® Finder ®ï¼èæå ¬å¸åæ¨) http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/ios/plugin.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/ios/plugin.md b/www/docs/zh-cn/6.x/guide/platforms/ios/plugin.md new file mode 100644 index 0000000..5ccdfdf --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/ios/plugin.md @@ -0,0 +1,184 @@ +--- +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: iOS 夿ç¨å¼ +--- + +# iOS 夿ç¨å¼ + +æ¤é¨åæä¾äºå¦ä½å¨ iOS å¹³èºä¸å¯¦ç¾æ¬æ©å¤æç¨å¼ä»£ç¢¼ç詳細è³è¨ã ä¹åè®éç¯æç« ï¼è«å鱿ç¨ç¨å¼å¤æç¨å¼å¤æç¨å¼ççµæ§åå ¶å ±åç JavaScript ä»é¢çæ¦è¿°ã éä¸ç¯ç¹¼çºè¡¨æéä¿¡å¾ç§ç¾å¤ç¦ web è¦åçæ¬æ©å¹³èºåå¾é¢ç示ä¾*åè²*夿ç¨å¼ã + +IOS 夿ç¨å¼ä½çºæ´å±ç®æ¨ C é¡å¯¦ç¾ `CDVPlugin` é¡ã å°æ¼ JavaScript ç `exec` æ¹æ³ç `service` 忏尿 å°å°ä¸åç®æ¨ C é¡ï¼æ¯å夿ç¨å¼å¿ é 註åçº `<feature>` æ¨è¨å½åçæç¨ç¨å¼ç®éä¸ `config.xml` æªã + +## 夿ç¨å¼é¡æ å° + +ä¸å夿ç¨å¼ç JavaScript é¨åä½¿ç¨ `cordova.exec` æ¹æ³ï¼å¦ä¸æç¤ºï¼ + + exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]); + + +éå°éä¸åè«æ±å¾ `UIWebView` å° iOS æ¬æ©ä¸å´ï¼ææå°èª¿ç¨ `action` æ¹æ³å¨ `service` é¡ï¼å³å ¥ç忏ä¸ç `args` é£åã + +æå®ä½çºå¤æç¨å¼ `<feature>` ç§ç¾å¤ç¦ iOS æç¨ç¨å¼å°æ¡ä¸çæ¨è¨ `config.xml` æªï¼ä½¿ç¨ `plugin.xml` æªä¾èªåæç¨ç¨å¼å¤æç¨å¼ä¸æè¿°æ³¨å ¥æ¤æ¨è¨ï¼ + + <feature name="LocalStorage"> + <param name="ios-package" value="CDVLocalStorage" /> + </feature> + + +該åè½ç `name` å±¬æ§æå¹é æ¨ææå®çä½çº JavaScript `exec` 調ç¨ç `service` 忏ã `value`å±¬æ§æè夿ç¨å¼çç®æ¨ C é¡çå稱ç¸å¹é ã `<param>`å ç´ ç `name` æå§çµæ¯ `ios-package` ã å¦æä½ ä¸éµå®éäºæºåï¼è©²å¤æç¨å¼å¯è½æç·¨è¯ï¼ä½ç§ç¾å¤ç¦å¯è½ä»ç¶ä¸è½å¤ 訪åå®ã + +## 夿ç¨å¼åå§åååçæ + +夿ç¨å¼ç©ä»¶çä¸å實ä¾åµå»ºçºçæ´»çæ¯å `UIWebView` ã é¦å å¾ JavaScript ç調ç¨çå¼ç¨æï¼éå¸¸è¢«å ·ç¾å夿ç¨å¼ã å¦åä»åå¯ä»¥ééè¨ç½®å ·ç¾å `param` å½åçº `onload` å° `true` å¨ `config.xml` æªï¼ + + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + <param name="onload" value="true" /> + </feature> + + +æ*æ²æ*æå®å¤æç¨å¼çåå§å¼è¨å®é ãç¸åï¼æä½¿ç¨å¤æç¨å¼ `pluginInitialize` çºå ¶ååéè¼¯æ¹æ³ã + +夿ç¨å¼éè¦é·æééè¡çè«æ±ï¼å¦åªé«éæã è½ç¾ï¼ä¿æå §é¨çæ æå·è¡çèæ¯æ´»å `onReset` æ¹æ³ä¾æ¸ çéäºæ´»åã 卿¹æ³éè¡æ `UIWebView` å®ä½å°æ°çä¸é æå·æ°ï¼éæ°è¼å ¥ JavaScriptã + +## å¯«ä½ iOS ç§ç¾å¤ç¦å¤æç¨å¼ + +JavaScript 調ç¨è§¸ç¼å¤æç¨å¼è«æ±å°æ¬æ©çä¸éï¼åç¸æç iOS ç®æ¨ C 夿ç¨å¼æ å°æ£ç¢ºå°å¨ `config.xml` æªä¸ï¼ä½æå¾ iOS ç®æ¨ C 夿ç¨å¼é¡çèµ·ä¾åä»éº¼ï¼ ç¡è«æ´¾å¾è JavaScript ç夿ç¨å¼ `exec` 彿¸å³éå°ç¸æç夿ç¨å¼é¡ç `action` æ¹æ³ã 夿ç¨å¼çæ¹æ³ææ¤ç°½åï¼ + + - (void)myMethod:(CDVInvokedUrlCommand*)command + { + CDVPluginResult* pluginResult = nil; + NSString* myarg = [command.arguments objectAtIndex:0]; + + if (myarg != nil) { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK]; + } else { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"]; + } + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + } + + +æéæ´å¤è©³ç´°è³è¨ï¼è«åè¦ `[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)` ï¼ `[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)` ï¼å`[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)`. + +## iOS CDVPluginResult è¨æ¯é¡å + +æ¨å¯ä»¥ä½¿ç¨ `CDVPluginResult` ä¾è¿åçµæçå¤ç¨®é¡åå JavaScript åå¼å½æ¸ï¼ä½¿ç¨é¡çæ¹æ³ï¼å®åéµå¾ªé種模å¼ï¼ + + + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs... + + +æ¨å¯ä»¥åµå»º `String` ï¼ `Int` ï¼ `Double` ï¼ `Bool` ï¼ `Array` ï¼ `Dictionary` ï¼ `ArrayBuffer` ï¼å `Multipart` é¡åã ä½ å¯ä»¥ä¹é¢éäºä»»ä½åæ¸ä¾ç¼éçæ ï¼æè¿åé¯èª¤ï¼æçè³é¸æä¸ç¼éä»»ä½å¤æç¨å¼ççµæï¼å¨éç¨®æ æ³ä¸æ¢ä¸åæ¥ç«ã + +è«æ³¨æä»¥ä¸è¤éçå³åå¼çºï¼ + +* `messageAsArrayBuffer`é è¨ `NSData*` 並å°è½æçº `ArrayBuffer` å¨ JavaScript åæªã 忍£ï¼ä»»ä½ `ArrayBuffer` JavaScript ç¼éå°ä¸å夿ç¨å¼é½å°è½æçº`NSData*`. + +* `messageAsMultipart`é è¨ï¼ `NSArray*` å å«ä»»ä½å ¶ä»æ¯æ´é¡åï¼ä¸¦å°ç¼éæ´åé£åä½çº `arguments` 給æ¨ç JavaScript åæªã é種æ¹å¼ï¼ææåæ¸å¨åºååæååºååä½çºå¿ è¦çæä»¥å®æ¯è½å¤ å®å ¨è¿å `NSData*` ä½çºå¤é¨åï¼ä½ä¸æ¯ `Array` /`Dictionary`. + +## åè² iOS 夿ç¨å¼ç¤ºä¾ + +è¥è¦å¹é ç JavaScript ä»é¢*åæ³¢*ç¹å¾µæè¿°çæç¨ç¨å¼å¤æç¨å¼ï¼ä½¿ç¨ `plugin.xml` 便³¨å ¥ `feature` å°æ¬å°å¹³èºè¦ç¯ `config.xml` æªï¼ + + <platform name="ios"> + <config-file target="config.xml" parent="/*"> + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + </feature> + </config-file> + </platform> + + +ç¶å¾æåå°æ·»å ä»¥ä¸ `Echo.h` å `Echo.m` æªå° `Plugins` å §ç§ç¾å¤ç¦ iOS æç¨ç¨å¼ç®éçè³æå¤¾ï¼ + + /********* Echo.h Cordova Plugin Header *******/ + + #import <Cordova/CDV.h> + + @interface Echo : CDVPlugin + + - (void)echo:(CDVInvokedUrlCommand*)command; + + @end + + /********* Echo.m Cordova Plugin Implementation *******/ + + #import "Echo.h" + #import <Cordova/CDV.h> + + @implementation Echo + + - (void)echo:(CDVInvokedUrlCommand*)command + { + CDVPluginResult* pluginResult = nil; + NSString* echo = [command.arguments objectAtIndex:0]; + + if (echo != nil && [echo length] > 0) { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:echo]; + } else { + pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR]; + } + + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + } + + @end + + +卿ªçé é¨å¿ è¦çé²å£ååæ´å±å¾é¡ `CDVPlugin` ã å¨éç¨®æ æ³ä¸ï¼è©²å¤æç¨å¼åªæ¯æ´å®å `echo` è¡åã å®ç²å echo å串ééèª¿ç¨ `objectAtIndex` æ¹æ³ç²åç第ä¸å忏 `arguments` å°æäºåæ¸çé£åéé JavaScript å¨ `exec()` 彿¸ã + +å®ææª¢æ¥è©²åæ¸ï¼ä»¥ç¢ºä¿å®ä¸æ¯ `nil` æç©ºå串ï¼è¿å `PluginResult` è `ERROR` 妿æ¯é樣ççæ ã å¦æè©²åæ¸ééæª¢æ¥ï¼å®è¿å `PluginResult` è `OK` çæ ï¼å¨åå§ä¸å³é `echo` çåä¸²ã æå¾ï¼å®å°ç¼éçµæå° `self.commandDelegate` ï¼å ¶ä¸å·è¡ `exec` æ¹æ³çæåæå¤±æåæª JavaScript ä¸éã 妿æååæªè¢«èª¿ç¨ï¼å®å°ééå¨ `echo` 忏ã + +## iOS ä¸é«å + +`CDVPlugin`é¡åè½å ¶ä»ä½ ç夿ç¨å¼å¯ä»¥éå¯«çæ¹æ³ã ä¾å¦ï¼æ¨å¯ä»¥æç² `[pause](../../../cordova/events/events.pause.html)` ï¼ `[resume](../../../cordova/events/events.resume.html)` ï¼æç¨ç¨å¼çµæ¢å `handleOpenURL` äºä»¶ã è«åè¦[CDVPlugin.h][1]å[CDVPlugin.m][2]é¡çæå°ã + + [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h + [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m + +## å·è¡ç· + +夿ç¨å¼æ¹æ³é常å¨ä¸»ä»é¢ç¸åçå·è¡ç·ä¸å·è¡ã å¦æä½ ç夿ç¨å¼éè¦å¤§éçèçï¼æè éè¦ä¸åé»å¡èª¿ç¨ï¼åæä½¿ç¨å¾èºå·è¡ç·ã ä¾å¦ï¼ + + - (void)myPluginMethod:(CDVInvokedUrlCommand*)command + { + // Check command.arguments here. + [self.commandDelegate runInBackground:^{ + NSString* payload = nil; + // Some blocking logic... + CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:payload]; + // The sendPluginResult method is thread-safe. + [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId]; + }]; + } + + +## 調試 iOS 夿ç¨å¼ + +è¥è¦èª¿è©¦çç®æ¨ C ä¸éï¼ä½ éè¦ Xcode çå §ç½®èª¿è©¦å¨ã å°æ¼ JavaScriptï¼å¨ iOS 5.0 ææ´é«çæ¬ä¸ä½ å¯ä»¥ä½¿ç¨ [Weinreã Apache ç§ç¾å¤ç¦å°æ¡][3] æ [iWebInspectorã ä¸åååå» å實ç¨ç¨å¼][4]ã Ios 8ï¼æ¨å¯ä»¥éå Safari 8.0 8 模æ¬å¨å¨ iOS ä¸éè¡çæç¨ç¨å¼ã + + [3]: https://github.com/apache/cordova-weinre + [4]: http://www.iwebinspector.com/ + +## 常è¦çé·é± + +* å¥å¿äºæ·»å å°æ¨çè ³æ¬æ å° `config.xml` ãå¦æä½ å¿è¨äºï¼æ¯å¨ Xcode 主æ§å°ä¸è¨éé¯èª¤ã + +* å¥å¿äºæ·»å ä»»ä½ä¸»æ©ï¼æ¨å¨ç½åå®ä¸ï¼é£æ¥å°åç½å宿åä¸æè¿°ãå¦æä½ å¿è¨äºï¼æ¯å¨ Xcode 主æ§å°ä¸è¨éé¯èª¤ã \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/6.x/guide/platforms/ios/tools.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/6.x/guide/platforms/ios/tools.md b/www/docs/zh-cn/6.x/guide/platforms/ios/tools.md new file mode 100644 index 0000000..2298a23 --- /dev/null +++ b/www/docs/zh-cn/6.x/guide/platforms/ios/tools.md @@ -0,0 +1,97 @@ +--- +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: iOS æ®¼å·¥å ·æå +--- + +# iOS æ®¼å·¥å ·æå + +æ¬æåæ¼ç¤ºå¦ä½ä½¿ç¨ç§ç¾å¤ç¦çå¥çå¹³èºçºä¸å¿ç夿®¼ç¨å¼å·¥å ·ä¾éç¼ iOS æç¨ç¨å¼ã é種ç¼å±éè·¯ï¼æ¦è¿°ä¸è¨è«å¯è½æçºæ¨æä¾æ´å»£æ³çç¼å±æ¹æ¡æï¼iOS æ¯æè¿°çå½ä»¤åä»é¢çè·¨å¹³èº CLI å·¥å ·ã ä¾å¦ï¼æ¨éè¦é¨ç½²ä¸åç§ç¾å¤ç¦ web è¦åèªè¨æéçæ¬æ©çµä»¶æä½¿ç¨å¤æ®¼ç¨å¼å·¥å ·ã å¨ä½¿ç¨ä¹åè¦éº¼ç¼å±è·¯å¾ï¼æ¨å¿ é é¦å é ç½® SDK ç°å¢ç iOS å¹³èºæåä¸æè¿°ã éäºå·¥å ·ä¾è³´äº Xcode çå½ä»¤åå·¥å ·å¦ `xcode-select` å`xcodebuild`. + +è¥è¦åç¨ iOS ç夿®¼å·¥å ·ï¼è«å¾[cordova.apache.org][1]ä¸è¼ç§ç¾å¤ç¦ã ä¸è¼æªæ¡ä¸å å«å®ç¨çæªæ¡ï¼çºæ¯åå¹³èºã å±éæ¯åæ¨æ³è¦çç®æ¨ï¼ `ios` å¨éç¨®æ æ³ä¸ã ç¸éçå·¥å ·ï¼é常å¯ç¨å¨é ç´ `bin` ç®éä¸ï¼å¦åçºè«®è©¢**èªè¿°**æªï¼çè§£æéæ´å¤è©³ç´°çæç¤ºã + + [1]: http://cordova.apache.org + +éäºå·¥å ·å 許æ¨åµå»ºã æ§å»ºåéè¡ iOS çæç¨ç¨å¼ã é¡å¤çå½ä»¤åä»é¢ï¼å¯ä»¥è·¨ææå¹³èºç夿ç¨å¼åè½çè³è¨ï¼è«åé±ä½¿ç¨ Plugman å°ç®¡ç夿ç¨å¼ã æéå¦ä½éç¼å¤æç¨å¼ç詳細è³è¨ï¼è«å鱿ç¨ç¨å¼å¤æç¨å¼ã + +## åµå»ºä¸åå°æ¡ + +éè¡ `create` å½ä»¤ï¼æå®çç¾æè·¯å¾çå°æ¡ã åååå¼å èå¥ç¢¼åæç¨ç¨å¼ç顯示å稱ã + + $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName + + +## çæå°æ¡ + + $ /path/to/my_new_project/cordova/build + + +## 卿¨¡æ¬å¨ä¸éè¡æç¨ç¨å¼ + + $ /path/to/my_new_project/cordova/run --emulator + + +## å¨è¨åä¸éè¡çæç¨ç¨å¼ + + $ /path/to/my_new_project/cordova/run --device + + +## 簽署æç¨ç¨å¼ + +ä½ å¯ä»¥çè§£æ´å¤éæ¼ç°½ç½²ã åç¼ iOS æç¨ç¨å¼ã åµå»ºèæ¸åè³æºèª¿é ä¸[iOS éç¼äººå¡åº«][2]çè¨å®æª. + + [2]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/ConfiguringYourApp/ConfiguringYourApp.html + +ç°½å¨ç§ç¾å¤ç¦ app éè¦å ·å以䏿¢ä»¶: + +* ä»£ç¢¼ç°½åæ¨è (`-codeSignIdentity`):[ä½¿ç¨ XCode][3]å¯ä»¥åµå»ºæ°ç iOS ç°½åæ¨è並å°å ¶æ·»å å°æ¨çé°å串ã é¡åç代碼簽å身份 â â é常å使ç¼å±ï¼éè¦å¨é裡æå®ã + +* è³æºèª¿é (`-provisioningProfile`) çè¨å®æª:[使ç¨èææå¡ä¸å¿][4]ä½ å¯ä»¥åµå»ºä¸åè³æºèª¿é çè¨å®æªã ä¸è¼å°æ¨çæ©å¨ä¸è¨ç½®çè¨å®æªä¸¦ååå®å¨ XCode ä¾è¨»åå®ã å®å¨ä½ ç Mac ä¸è¤è£½å°æ¤è: ~/Library/MobileDevice/Provisioning\ è¨å®æª /ã 卿å編輯å¨ä¸æéå®ï¼ä½ å¯ä»¥æ¾å°ï¼éè¦å¨æ¤èæå®ç UUIDã + +* 代碼簽åè³æºè¦å (`-codeSignResourceRules`) (å¯é¸): å è¨±æ¨æå®èªè¨ç°½åè³æºè¦åã + + [3]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html#//apple_ref/doc/uid/TP40012582-CH31-SW6 + [4]: https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html#//apple_ref/doc/uid/TP40012582-CH30-SW61 + +å¯ä»¥ä½¿ç¨`çæ`æ`éè¡`è ³æ¬ä¸é¢çå½ä»¤å忏æå®éäºåæ¸: + + $ /path/to/my_new_project/cordova/build --codeSignIdentity="iPhone Distribtion" --provisioningProfile="926c2bd6-8de9-4c2f-8407-1016d2d12954" + + +æè ï¼æ¨å¯ä»¥æå®å®åå¨çµå»ºçµæ æª ï¼build.jsonï¼ ä¸ä½¿ç¨ ï¼`--buildConfig`) çè«é»ãä¸é¢æ¯çµå»ºçµæ æªçä¸å示ä¾ï¼ + + { + "ios": { + "debug": { + "codeSignIdentity": "iPhone Development", + "provisioningProfile": "926c2bd6-8de9-4c2f-8407-1016d2d12954" + }, + "release": { + "codeSignIdentity": "iPhone Distribution", + "provisioningProfile": "70f699ad-faf1-4adE-8fea-9d84738fb306" + } + } + } + + +æ¤å¤ï¼å®éæ¯æ´ä»¥æ··ååå¹é çå½ä»¤å忏å build.json æªä¸ç忏ãå¾å½ä»¤å忏çå¼å°æå¾å°åªå ã + +## æ¥èªè¨é + + $ /path/to/my_new_project/cordova/log --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org