http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md new file mode 100644 index 0000000..3ed51d4 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/blackberry10/upgrading.md @@ -0,0 +1,457 @@ +--- +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 çæ¬ã + +## å¾ 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/file/fileobj/fileobj.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/file/fileobj/fileobj.html) ï¼ä»¥åå å«è©²è ³æ¬å¼ç¨çä»»ä½å ¶ä»æªï¼ 以æåæ° `cordova.js` æªã + +7. è¤è£½ `native` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èèå¾æ°å°æ¡ç®é `native` ç®éã + +8. è¤è£½ `lib` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èèå¾æ°å°æ¡ç®é `lib` ç®éã + +9. è¤è£½ `cordova` å°ç¾æå°æ¡ä¸ï¼ä¸¦è¦èèå¾æ°å°æ¡ç®é `cordova` ç®éã + +## åç´ 2.7.0 å°æ¡å° 2.8.0 + +é»è 10ï¼ + +é»è 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/file/fileobj/fileobj.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/file/fileobj/fileobj.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/file/fileobj/fileobj.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 [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.2.3.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.3.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.3.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.2.2.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.2.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.2.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.2.1.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.1.0/ext-air/` ç®éã + +4. æ´æ°çå §å®¹ `cordova.2.1.0/ext-qnx/` ç®éã + +5. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.2.0.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.2.0.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.1.9.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.1.9.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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 [æª](../../../cordova/file/fileobj/fileobj.html) `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/file/fileobj/fileobj.html) `cordova.1.7.0/ext/` ç®éã + +3. æ´æ°çå §å®¹ `cordova.1.7.0/ext-air/` ç®éã + +4. æ´æ°ä¸ç.js [æª](../../../cordova/file/fileobj/fileobj.html) `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/3.1.0/guide/platforms/firefoxos/config.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/firefoxos/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/firefoxos/config.md new file mode 100644 index 0000000..b56a61b --- /dev/null +++ b/www/docs/zh-cn/3.1.0/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/3.1.0/guide/platforms/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/index.md new file mode 100644 index 0000000..0a453ca --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/index.md @@ -0,0 +1,79 @@ +--- +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` å½ä»¤å實ç¨ç¨å¼ã + +## Android 系統 + +* [Android å¹³èºæå](android/index.html) +* [Android 系統çµæ ](android/config.html) +* [Android WebViews](android/webview.html) +* [Android å¤æç¨å¼](android/plugin.html) +* [Android 系統çå½ä»¤åå·¥å ·](android/tools.html) +* [åç´ Android](android/upgrading.html) + +## é»èææ© + +* [é»èå¹³èºæå](blackberry/index.html) +* [é»èææ©é ç½®](blackberry10/config.html) +* [é»èææ©çå½ä»¤åå·¥å ·](blackberry/tools.html) +* [åç´é»èææ©](blackberry10/upgrading.html) + +## é»è 10 + +* [10 é»èå¹³èºæå](blackberry10/index.html) +* é»è 10 [é ç½®](../../cordova/media/capture/ConfigurationData.html) +* [é»è 10 å¤æç¨å¼](blackberry10/plugin.html) +* [é»è 10 å½ä»¤åå·¥å ·](blackberry10/tools.html) + +## iOS + +* [iOS å¹³èºæå](ios/index.html) +* [iOS é ç½®](ios/config.html) +* [WebViews iOS](ios/webview.html) +* [iOS å¤æç¨å¼](ios/plugin.html) +* [iOS å½ä»¤åå·¥å ·](ios/tools.html) +* [åç´ iOS](ios/upgrading.html) + +## Windows Phone + +* [Windows Phone 8 å¹³èºæå](wp8/index.html) +* [Windows Phone 7 å¹³èºæå](wp7/index.html) +* Windows Phone [é ç½®](../../cordova/media/capture/ConfigurationData.html) +* [Windows Phone çå½ä»¤åå·¥å ·](wp8/tools.html) +* [åç´ Windows Phone](wp8/upgrading.html) + +## Windows 8 + +* [Windows 8 å¹³èºæå](win8/index.html) +* [Windows 8 çå½ä»¤åå·¥å ·](win8/tools.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/3.1.0/guide/platforms/ios/config.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md new file mode 100644 index 0000000..4b25401 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/config.md @@ -0,0 +1,99 @@ +--- +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 æªçè³è¨ã + +* `EnableViewportScale`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` 使ç¨è¦åçå æ¨è¨ä¾ç¦ç¨æéå¶ç使ç¨è 縮æ¾çç¯åã + + <preference name="EnableViewportScale" value="true"/> + + +* `MediaPlaybackRequiresUserAction`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` 以é²æ¢ HTML5 è¦é »èªåææ¾ç `autoplay` 屬æ§ã 調ç¨æï¼ä¸é©ç¨ `play()` è¦é »ç©ä»¶ä¸ã + + <preference name="MediaPlaybackRequiresUserAction" value="true"/> + + +* `AllowInlineMediaPlayback`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` ï¼è® HTML5 ææ¾åªé«é¡¯ç¤º*å §è¯*çè¢å¹ä½å±ï¼ä½¿ç¨ç覽å¨æä¾çæ§å¶é ï¼èä¸æ¯æ¬æ©æ§å¶é å §ã çºæ¤ï¼æ·»å `webkit-playsinline` æ¸åäºä»»ä½ `<video>` çå ç´ ã + + <preference name="AllowInlineMediaPlayback" value="true"/> + + +* `BackupWebStorage`ï¼å串ï¼æè `none` ï¼ `local` ï¼æé è¨ç `cloud` ï¼ï¼ è¨ç½®çº `cloud` å 許éé iCloud åä»½å° web åå²è³æã è¨ç½®çº `local` ï¼ä½¿å¾åªææ¬å°å份éé iTunes åæ¥ã è¨ç½®çº `none` é²æ¢ web åå²å份ã + + <preference name="BackupWebStorage" value="local"/> + + +* `TopActivityIndicator`ï¼å串ï¼é è¨å¼çº `gray` ï¼ï¼ æ§å¶æ示大éçèçå¨æ´»åççæ åä¸çæè½çå°å示çå¤è§ã ææçå¼çº `whiteLarge` ï¼ `white` ï¼å`gray`. + + <preference name="TopActivityIndicator" value="white"/> + + +* `FadeSplashScreen`(boolean é¡åçå¼ï¼é è¨å¼çº `true` ï¼ï¼ è¨ç½®çº `false` 以é²æ¢è¤ªè²å縮å°å ¶é¡¯ç¤ºçæ ç¼çæ´æ¹æåå§è¢å¹ã + + <preference name="FadeSplashScreen" value="false"/> + + +* `FadeSplashScreenDuration`ï¼æµ®åï¼é è¨å¼çº `2` ï¼ï¼ æå®çåå§è¢å¹çç§æ¸æ·¡åºææä¾å·è¡ã + + <preference name="FadeSplashScreenDuration" value="4"/> + + +* `ShowSplashScreenSpinner`(boolean é¡åçå¼ï¼é è¨å¼çº `true` ï¼ï¼ è¨ç½®çº `false` é±èåå§è¢å¹å¾®èª¿æ¡ã + + <preference name="ShowSplashScreenSpinner" value="false"/> + + +* `KeyboardDisplayRequiresUserAction`(boolean é¡åçå¼ï¼é è¨å¼çº `true` ï¼ï¼ è¨ç½®çº `false` ï¼å 許éµç¤åºç¾å¨èª¿ç¨æ `focus()` å½¢å¼æå ¥ã + + <preference name="KeyboardDisplayRequiresUserAction" value="false"/> + + +* `SuppressesIncrementalRendering`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` çå¾ ï¼ç´å°å¨åç¾å°è¢å¹ä¹åå·²æ¶å°çææå §å®¹ã + + <preference name="SuppressesIncrementalRendering" value="true"/> + + +* `KeyboardShrinksView`(boolean é¡åçå¼ï¼é è¨å¼çº `false` ï¼ï¼ è¨ç½®çº `true` è¦æ¨¡ web è¦åï¼ç¶éµç¤åºç¾æï¼é寫é è¨ beaviorï¼æ²¿åç´æ¹å縮å°è¦åã éèå¹é Android æç¨ç¨å¼çé è¨çè¡çºã + + <preference name="KeyboardShrinksView" value="true"/> + + +* `GapBetweenPages`ï¼æµ®åï¼é è¨å¼çº `` ï¼ï¼ ç大å°ï¼ä»¥ç£ çºå®ä½ï¼é é¢ä¹éçå·®è·ã + + < é¦é¸é å稱 = å¼"GapBetweenPages"="0"/ > + + +* `PageLength`ï¼æµ®åï¼é è¨å¼çº `` ï¼ï¼ ä¸é»ï¼å¨é é¢æµçæ¹åæ¯åé é¢ç大å°ã ç¶ PaginationMode æ¯å¾å³è³å·¦æå¾å·¦è³å³ï¼æ¤å±¬æ§å·¥ä½è¡¨ç¤ºæ¯åé é¢ç寬度ã PaginationMode topToBottom æ bottomToTop æï¼æ¤å±¬æ§å·¥ä½è¡¨ç¤ºæ¯åé é¢çé«åº¦ã é è¨å¼çº 0ï¼éæå³èä½å±ä½¿ç¨è¦åç大å°ä¾ç¢ºå®é é¢ç尺寸ã + + < é¦é¸é å稱 = å¼"PageLength"="0"/ > + + +* `PaginationBreakingMode`ï¼å串ï¼é è¨å¼çº `page` ï¼ï¼ ææçå¼çº `page` å `column` ãå¨åæé æ·ç¼ççæ¹å¼ã æ¤å±¬æ§ç¢ºå®æ¯å¦æäº CSS 屬æ§éæ¼ååé æç ´æ¯æ¦®å¹¸éæ¯å¿½ç¥ã ç¶æ¤å±¬æ§è¨ç½®çº `column` ï¼å §å®¹å°éç¸éçé æ·çå°æ¹æ·åç CSS 屬æ§ã + + < é¦é¸é å稱 = å¼"PaginationBreakingMode"="第é "/ > + + +* `PaginationMode`ï¼å串ï¼é è¨å¼çº `unpaginated` ï¼ï¼ ææçå¼çº `unpaginated` ï¼ `leftToRight` ï¼ `topToBottom` ï¼ `bottomToTop` ï¼å `rightToLeft` ã æ¤å±¬æ§ç¢ºå®æ¯å¦å¨ web è¦åä¸çå §å®¹ååçºä¸æ¬¡å¡«å è¦åä¸è¢å¹çé æä¸åé·ç滾åè¦åæ示ã å¦æè¨ç½®çºä¸ååé ç表å®ï¼æ¤å±¬æ§åæåé çä½å±ä¸çå §å®¹ï¼å°è´å ¶å §å®¹ç web è¦å使ç¨éæ°ä½å±ç PageLength å GapBetweenPages çå¼ã + + < é¦é¸é å稱 = å¼"PaginationMode"="åé "/ > \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md new file mode 100644 index 0000000..b438aab --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/index.md @@ -0,0 +1,171 @@ +--- +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 [è¨å](../../../cordova/device/device.html) ï¼å¦ 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.7 (ç å) çæ¬ä¸éè¡ Xcode ® 4.5 (è¦æ±çæä½çæ¬ï¼ ææ´å¤§ï¼ä¸¦å æ¬ iOS 6 SDK ï¼è»é«ç¼å±å·¥å ·çµï¼ã è¦æ交å°èæ App Storeâ çæç¨ç¨å¼éè¦çèæå·¥å ·çææ°çæ¬ã + +æ¨å¯ä»¥æ¸¬è©¦ç許å¤ç§ç¾å¤ç¦åè½ä½¿ç¨ iOS 模æ¬å¨å®è£ ios SDK å Xcodeï¼ä½ä½ éè¦ä½¿ç¨å¯¦éçè¨åå®å ¨æäº¤å° App Store ä¹å測試çæææç¨ç¨å¼çè£ç½®åè½ã 該è¨åå¿ é è³å°æ iOS 5.x å®è£ã ç§ç¾å¤ç¦ 2.3 æ¯æ´çæä½é度ç iOS çæ¬ãé å¥è¨åå æ¬ææ iPad ® 模åã iPhone ® 3GS å以ä¸ï¼å iPod ® 觸æ¸ç¬¬ä¸ä»£ææ´é«çæ¬ã è¦å®è£å°è¨åä¸çæç¨ç¨å¼ï¼æ¨å¿ é ä¹æ¯èæå ¬å¸ç[iOS éç¼è è¨ç«][1]ï¼è©²è²»ç¨æ¯ 99 å¹´ç¾å çæå¡ã æ¬æåæ¼ç¤ºå¦ä½å°æç¨ç¨å¼é¨ç½²å° iOS 模æ¬å¨ï¼ä¸å¿ 註åéç¼è è¨ç«ã + + [1]: https://developer.apple.com/programs/ios/ + +## å®è£ SDK + +æå ©ç¨®æ¹æ³å¯ä»¥ä¸è¼ Xcodeï¼ + +* å¾[æç¨ç¨å¼ååº][2]ï¼å¯ééæç´¢"Xcode"å¨**App Store**ä¸çæç¨ã + +* å¾[èæéç¼è ä¸è¼][3]ï¼èä½çºèæéç¼è éè¦è¨»åã + + [2]: https://itunes.apple.com/us/app/xcode/id497799835?mt=12 + [3]: https://developer.apple.com/downloads/index.action + +ä¸æ¦å®è£äº Xcodeï¼å¹¾åå½ä»¤åå·¥å ·éè¦çºç§ç¾å¤ç¦éè¡åç¨ã å¾**Xcode**åè½è¡¨ä¸ï¼é¸æ**é¦é¸é **ï¼ç¶å¾**ä¸è¼**é¸é å¡ã å¾**å 件**é¢æ¿ä¸ï¼æ**å½ä»¤åå·¥å ·**æ¸ å®æéç**å®è£**æéã + +## å¨ SDK ä¸æéçå°æ¡ + +ä½¿ç¨ `cordova` 實ç¨ç¨å¼è¨ç½®äºä¸åæ°çå°æ¡ï¼å¦æè¿°å¨ç§ç¾å¤ç¦å½ä»¤åä»é¢ãä¾å¦ï¼å¨åå§ç¨å¼ç¢¼ä¸çç®éï¼ + + $ cordova create hello com.example.hello "HelloWorld" + $ cd hello + $ cordova platform add ios + $ cordova prepare # or "cordova build" + + +åµå»ºå¾ï¼æ¨å¯ä»¥å¨ Xcode å §æéå®å¾ãæå ©ä¸æé `hello/platforms/ios/hello.xcodeproj` æªãè¢å¹æ該å¦ä¸æç¤ºï¼ + +![][4] + + [4]: {{ site.baseurl }}/static/img/guide/platforms/ios/helloworld_project.png + +## é¨ç½²å°æ¨¡æ¬ç¨å¼ + +è¥è¦é 覽 iOS 模æ¬å¨ä¸çæç¨ç¨å¼ï¼ + +1. è«ç¢ºä¿å¨å·¦éçé¢æ¿ä¸é¸æ*.xcodeproj*æªã + +2. é¸æ**ä½ å¥½**app ç«å³åå³é¢æ¿ä¸ã + +3. å¾å·¥å ·åä¸ç**è¨ç«**åè½è¡¨ä¸é¸æé å®çè¨åã iPhone çä½çº 6.0 模æ¬å¨å¨é裡çªåºäºï¼ + + ![][5] + +4. æä¸**éè¡**æéåºç¾å¨åä¸å·¥å ·åå·¦å´ç**è¨ç«**ä¸ã é£çæã é¨ç½²ä¸¦å¨æ¨¡æ¬å¨ä¸éè¡æç¨ç¨å¼ã ä¸åå®ç¨ç模æ¬å¨æç¨ç¨å¼å°æéï¼ä¸¦é¡¯ç¤ºè©²æç¨ç¨å¼ï¼ + + ![][6] + + åªæä¸å模æ¬ç¨å¼å¯è½æéè¡ä¸æ¬¡ï¼æ以å¦æä½ æ³è¦å¨ä¸åç模æ¬å¨ä¸æ¸¬è©¦æç¨ç¨å¼ï¼æ¨éè¦éåºç模æ¬ç¨å¼æç¨ç¨å¼åéè¡ä¸åä¸åçç®æ¨å¨ Xcode çç¯åå §ã + + [5]: {{ site.baseurl }}/static/img/guide/platforms/ios/select_xcode_scheme.png + [6]: {{ site.baseurl }}/static/img/guide/platforms/ios/HelloWorldStandard.png + +Xcode æç¶äºæ¨¡æ¬å¨çºææ°çæ¬ç iPhone å iPadã è¼èççæ¬ä¸å¯è½ææä¾**Xcode â é¦é¸é â ä¸è¼ â å 件**é¢æ¿ã + +## å°é¨ç½²å°è¨å + +æéåé è¦æ±ï¼é¨ç½²å°ä¸åè¨åç詳細è³è¨ï¼è«åé±èæç[iOS å·¥å ·å·¥ä½æµæå][7]ç*é ç½®éç¼ååé è³ç¢*é¨åã ç°¡å®å°èªªï¼æ¨éè¦é¨ç½²ä¹åå·è¡ä»¥ä¸æä½ï¼ + + [7]: 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 + +1. å å ¥èæ iOS éç¼è è¨ç«ã + +2. åµå»º*è³æºèª¿é è¨å®æª*å §[iOS è³æºèª¿é éæ¶][8]ã æ¨å¯ä»¥ä½¿ç¨å ¶*ç¼å±è³æºèª¿é å©ç*ä¾åµå»ºåå®è£è¨å®æªåèæ¸ Xcode éè¦ã + +3. é©è*代碼簽å*é¨å*代碼簽åæ¨è*å §çå°æ¡è¨ç½®è¨ç½®çºæ¨è¨ç½®çè¨å®æªå稱ã + + [8]: https://developer.apple.com/ios/manage/overview/index.action + +è¥è¦é¨ç½²å°è¨åï¼ + +1. ä½¿ç¨ USB é»çºå°è¨åæå ¥å°æ¨ç macã + +2. Xcode è¦çª**è¨ç«**ä¸ææ¸ å®ä¸é¸æçå°æ¡çå稱ã + +3. å¾**è¨å**ä¸ææ¸ å®ä¸é¸ææ¨çè¨åãå¦æå®éé USB é£æ¥é»æºï¼ä½ä»ç¶æ²æåºç¾ï¼è«æ**管çå¨**æéï¼ä»¥è§£æ±ºä»»ä½é¯èª¤ã + +4. æä¸**éè¡**æé以çæã é¨ç½²ä¸¦éè¡è©²æç¨ç¨å¼å¨æ¨çè¨åä¸ã + +## 常è¦çåé¡ + +**å¦æ±ºè¦åï¼**ç¶æç¨ç¨å¼æ´æ¹ææ¿æçºå¦ä¸å API ç¨å¼è¨è¨ä»é¢ (API) æï¼å®è¢«æ¨è¨çº*å·²éæ*ã API ä»å¯å·¥ä½ï¼çæå §ï¼ä½æçµå°è¢«åªé¤ã éäºéæçä»é¢çä¸äºåæ å¨ Apache ç§ç¾å¤ç¦å Xcode åé¡å°ä»åçè¦åæ¨å¨çæåé¨ç½²æç¨ç¨å¼æã + +Xcode çè¦å `invokeString` æ¹æ³æ¶åååä¸åæç¨ç¨å¼å¾ä¸åèªè¨ URL çåè½ã éç¶å¾èªè¨ URL è¼å ¥çæ©å¶ç¼çäºè®åï¼æ¤ä»£ç¢¼ç®åä»å¨ç¹¼çºçºç§ç¾å¤ç¦çè¼æ©çæ¬åµå»ºçæç¨ç¨å¼æä¾åå¾çåè½ã æç¨ç¨å¼ç¯ä¾ä¸ä½¿ç¨éä¸åè½ï¼å æ¤å¯ä»¥å¿½ç¥éäºè¦åã è¥è¦é²æ¢åºç¾éäºè¦åï¼è«åªé¤å¼ç¨å·²æ£ç¨ç invokeString API çä»£ç¢¼ï¼ + +* 編輯*Classes/MainViewController.m*æªã ç°ç¹ç代碼èä¸é¢çå¡ `/*` å `*/` çè©è«å¦ä¸æ示ï¼ç¶å¾éµå ¥**å½ä»¤-s**ä¿å該æªï¼ + + ï¼å¤±æï¼ webViewDidFinishLoad:(UIWebView*) theWebView {/ / å¦æ ___PROJECTNAME__ Info.plist æå®åå®ä¾èççå¯ä¸ææ / * å¦æ (self.invokeString) {/ / éå³éä¹åè§¸ç¼ deviceready äºä»¶ï¼ä»¥ä¾¿æ¨å¯ä»¥è¨ªåå®ç js ææ¨ææ¶å° deviceready NSLog (@"å·²å¦æ±ºï¼ window.invokeString-ç¸åï¼ä½¿ç¨ window.handleOpenURL(url) å½æ¸ï¼ç¸½æ¯èª¿ç¨ééèªè¨æ¹æ¡ url ååæç¨ç¨å¼æ.") ï¼NSString * jsString = [NSString stringWithFormat:@"var invokeString = \"%@\"ï¼"self.invokeString] ï¼[theWebView stringByEvaluatingJavaScriptFromString:jsString] ï¼} * / / / é»è²åºå½©è²èæ¯å¹é çæ¬æ©æç¨ç¨å¼ theWebView.backgroundColor = [UIColor blackColor] ï¼è¿å [è¶ ç´ 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. å¨**æ´¾ççè³æ**é¨åä¸ï¼æ**é«ç´**æé並é¸æ**å¯ä¸**ä½çº**çæä½ç½®**å¦ä¸æç¤ºï¼ + + ![][9] + + [9]: {{ site.baseurl }}/static/img/guide/platforms/ios/xcode_build_location.png + +éæ¯é è¨è¨ç½®çºä¸åæ°ç Xcode å®è£ï¼ä½ä¹å¯ä»¥è¨ç½®ä»¥ä¸åçæ¹å¼å¾è¼æ©çæ¬ç Xcode å¾åç´ã + +é²ä¸æ¥çè³è¨ï¼è«åèèæçææªï¼ + +* [éå§éç¼ iOS æç¨ç¨å¼ä»å¤©][10]å¿«éæ¦è¿°çæ¥é©éç¼ iOS çæç¨ç¨å¼ã + +* [æå¡ä¸å¿ä¸»é ][11]æä¾å¹¾å iOS çé£çµæè¡è³æºå æ¬æè¡è³æºï¼è³æºèª¿é éæ¶ã åä½æåå社åè«å£ã + +* [IOS å·¥å ·å·¥ä½æµæå][7] + +* [Xcode 4 使ç¨è æå][12] + +* å¾èæä¸ç廣æ³éç¼äººå¡æè° (WWDC2012) 2012å¹´[å±æè°è¦é »][13] + +* å®è£[xcode é¸æå½ä»¤][14]ï¼å®æå©æ¼æå®æ£ç¢ºçæ¬ç Xcodeï¼å¦æä¸æ¢ä¸åç話ã + + [10]: http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343 + [11]: https://developer.apple.com/membercenter/index.action + [12]: http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215 + [13]: https://developer.apple.com/videos/wwdc/2012/ + [14]: http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html + +(Mac ®ï¼OS X ®ï¼èæå ¬å¸ Â®ï¼Xcode ® æç¨ç¨å¼ Storeâ ï¼iPad ®ï¼iPhone ®ï¼iPod ® å Finder ® æ¯èæå ¬å¸åæ¨) http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md new file mode 100644 index 0000000..83f5be2 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/plugin.md @@ -0,0 +1,202 @@ +--- +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 å¤æç¨å¼ + +å¤æç¨å¼æ¯ä¸åæ´å±çç®æ¨ C é¡ `CDVPlugin` é¡ã + +æ¯åå¤æç¨å¼é¡å¿ é 註åçº `<feature>` ä¸æ¨ç±¤ç `config.xml` æªã æ£æ¯éééä¸æ©å¶ç JavaScript `exec` æ¹æ³ç `service` åæ¸å°æ å°å°ç®æ¨ C é¡ã + +## å¤æç¨å¼é¡æ å° + +ä¸åå¤æç¨å¼ç JavaScript é¨åå§çµä½¿ç¨ `cordova.exec` æ¹æ³ï¼å¦ä¸æç¤ºï¼ + + exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]); + + +éå°éä¸åè«æ±å¾ `UIWebView` å° iOS æ¬æ©å´ï¼æ´æè¼ä¸æ²¸é¨°å°èª¿ç¨ `action` æ¹æ³ `service` é¡ï¼å³å ¥çåæ¸ä¸ç `args` é£åã + +æå®å¤æç¨å¼ä½çº `<feature>` å¨ç§ç¾å¤ç¦ iOS æç¨ç¨å¼å°æ¡ä¸çæ¨è¨ `config.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` `name` 屬æ§è¨ç½®çº `"true"` ç `config.xml` ã ä¾å¦ï¼ + + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + <param name="onload" value="true" /> + </feature> + + +æ*æ²æ*æå®å¤æç¨å¼çåå§å¼è¨å®é ãç¸åï¼æ使ç¨å¤æç¨å¼ `pluginInitialize` ä»åé辦çé輯æ¹æ³ã + +é·æééè¡çè«æ±ï¼å¤æç¨å¼èæ¯æ´»å ï¼ä¾å¦ï¼ææ¾çåªé«ï¼ï¼è½ç¾æå §é¨çæ æå·è¡ `onReset` æ¹æ³ååæ¢ææ¸ çéäºæ´»åã é種æ¹æ³éè¡æ `UIWebView` å®ä½å°æ°çä¸é æå·æ°ï¼éæ°è¼å ¥ JavaScriptã + +## å¯«ä½ iOS ç§ç¾å¤ç¦å¤æç¨å¼ + +æåæå¤æç¨å¼è«æ±å°æ¬æ©ç«¯ JavaScript èµ·ç«ççã æåæééæ£ç¢ºæ å°çç®æ¨ C ç iOS å¤æç¨å¼ `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]; + } + + +1. [CDVInvokedUrlCommand.h][1] + +2. [CDVPluginResult.h][2] + +3. [CDVCommandDelegate.h][3] + + [1]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h + [2]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h + [3]: 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 åæª ï¼å `ArrayBuffers` å¾ JavaScript ç¼éå°ä¸åå¤æç¨å¼é½å°è½æçº`NSData*`). +* `messageAsMultipart` é è¨ `NSArray *` å å«ä»»ä½å ¶ä»æ¯æ´é¡åï¼ä¸¦å°æ´åé£åä½çºç¼é `åæ¸` 給æ¨ç JavaScript åæªã + * æªçï¼ éä¸æ¯åªæ¯èªæ³ç³ ï¼å管å®æ¯ççï¼ã é種æ¹å¼ï¼ææåæ¸åºååæååºååï¼å¿ è¦æã ä¾å¦ï¼å®æ¯è½å¤ å®å ¨è¿å `NSData*` ä½çºå¤é¨åï¼ä½ä¸æ¯ `Array` /`Dictionary`. + +## Echo å¤æç¨å¼ iOS å¤æç¨å¼ + +æåæå°ä»¥ä¸å §å®¹æ·»å å°è©²å°æ¡ç `config.xml` æªï¼ + + <feature name="Echo"> + <param name="ios-package" value="Echo" /> + </feature> + + +ç¶å¾æåå°æ·»å ä¸åæª ï¼ `Echo.h` å `Echo.m` ï¼ å°æåç§ç¾å¤ç¦ 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` æ¹æ³ä¸çæå `args` ï¼å訴å®æåæ³è¦ç²åçåæ¸é£åä¸ç第åçåæ¸ã æååä¸äºåæ¸æª¢æ¥ï¼ è«ç¢ºä¿å®ä¸æ¯ `nil` ï¼ä¸¦ç¢ºä¿å®ä¸æ¯ä¸åé¶é·åº¦çå串ã + +å¦ææ¯ï¼æåè¿å `PluginResult` è `ERROR` çæ ã å¦æææéäºæª¢æ¥ééï¼ç¶å¾æåå°è¿å `PluginResult` è `OK` çæ ï¼ä¸¦ééå¨ `echo` æåæ¶å°äºå¨ç¬¬ä¸ä½ä½çºåæ¸çå串ã + +æå¾ï¼æåç¼éçµæå° `self.commandDelegate` ï¼å ¶ä¸å·è¡ `exec` æ¹æ³çæåæ失æåæª JavaScript ä¸éã å¦ææååæªè¢«èª¿ç¨ï¼å®å°ééå¨ `echo` åæ¸ã + +## å·è¡ç· + +å¨ç¸åç UI å·è¡ç·ä¸å·è¡çå¤æç¨å¼æ¹æ³ãå¦æä½ çå¤æç¨å¼éè¦å¤§éçèçï¼æè éè¦ä¸åé»å¡èª¿ç¨ï¼åæ使ç¨å¾èºå·è¡ç·ãä¾å¦ï¼ + + - (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]; + }]; + } + + +## é«ç´çå¤æç¨å¼åè½ + +è«åé±å ¶ä»æ¹æ³æï¼æ¨å¯ä»¥å¨éå¯«ï¼ + +* [CDVPlugin.h][4] + +* [CDVPlugin.m][5] + + [4]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.h + [5]: https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m + +ä¾å¦ï¼ä½ å¯ä»¥ææ¥å° `pause` ï¼ `resume` ï¼æç¨ç¨å¼çµæ¢å `handleOpenURL` äºä»¶ã + +## 調試å¤æç¨å¼ + +è¥è¦èª¿è©¦çç®æ¨ C å´ï¼æ¨å°ä½¿ç¨ Xcode çå §ç½®èª¿è©¦å¨ã å°æ¼ JavaScriptï¼å¨ iOS 5.0 å¯ä»¥ä½¿ç¨[Weinreã Apache ç§ç¾å¤ç¦å°æ¡][6]æ[iWebInspectorã ä¸åååå» å實ç¨ç¨å¼][7] + + [6]: https://github.com/apache/cordova-weinre + [7]: http://www.iwebinspector.com/ + +Ios 6ï¼æ¨å°ä½¿ç¨ Safari 6.0 å°ç°¡å®å°éå å°æ¨çæç¨ç¨å¼éè¡å¨ iOS 6 模æ¬å¨ã + +## 常è¦çé·é± + +* å¥å¿äºå 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/3.1.0/guide/platforms/ios/tools.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md b/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md new file mode 100644 index 0000000..603bbd3 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/guide/platforms/ios/tools.md @@ -0,0 +1,55 @@ +--- +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 å½ä»¤åå·¥å · + +`cordova`å½ä»¤å實ç¨ç¨å¼æ¯ä¸åé«ç´å¥çå·¥å ·ï¼å 許æ¨å¨ä¸æ¬¡è·¨å¹¾åå¹³èºçæçæç¨ç¨å¼ã èçæ¬çç§ç¾å¤ç¦æ¡æ¶æä¾äºç¹å®äºæ¯åå¹³èºçå½ä»¤åå·¥å ·éã è¥è¦ä½¿ç¨å®åä½çº CLI çæ¿ä»£ï¼æ¨éè¦å¾[cordova.apache.org][1]ä¸è¼æ¤çæ¬çç§ç¾å¤ç¦ã ä¸è¼æªæ¡ä¸å å«å®ç¨çæªæ¡ï¼çºæ¯åå¹³èºã å±éæ¨æ³è¦çç®æ¨å¹³èºã é裡æè¿°çå·¥å ·ï¼é常å¯ç¨å¨é ç´ `bin` ç®éä¸ï¼å¦åçºè«®è©¢**èªè¿°**æªï¼ç解æéæ´å¤è©³ç´°çæ示ã + + [1]: http://cordova.apache.org + +IOS å½ä»¤åå·¥å ·é½å»ºç«å¨ shell è ³æ¬åä¾è³´äº Xcode å½ä»¤åå·¥å ·å¦ `xcode-select` å`xcodebuild`. + +## åµå»ºä¸åå°æ¡ + +éè¡ `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 + + +## éæ¾ + + $ /path/to/my_new_project/cordova/release + + +## æ¥èªè¨é + + $ /path/to/my_new_project/cordova/log \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org For additional commands, e-mail: commits-h...@cordova.apache.org