http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/plugin-development/windows-phone/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/plugin-development/windows-phone/index.md b/docs/en/2.8.0rc1/guide/plugin-development/windows-phone/index.md deleted file mode 100644 index c2ec89d..0000000 --- a/docs/en/2.8.0rc1/guide/plugin-development/windows-phone/index.md +++ /dev/null @@ -1,191 +0,0 @@ ---- -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. ---- - -Developing a Plugin on Windows Phone -==================================== - -Writing a plugin for Cordova on Windows Phone requires a basic understanding of -the architecture of Cordova. Cordova-WP7 consists of a WebBrowser which hosts the -application javascript code and manages native API calls. There is a BaseCommand -(`WP7CordovaClassLib.Cordova.Commands.BaseCommand`) class in C# which you can extend, -and it comes with the majority of the 'plumbing' built for you already. - -1. Select your project, and right click choose 'Add -> New Item ...' - - Preferably add it to the 'Plugins' folder, but it is up to you -2. Select 'Class' and name it `Echo.cs` - - The name of this class must EXACTLY match what you call into `cordova.exec(win, fail, "Echo", ...)` -3. Include the base classes implementation - - using WPCordovaClassLib.Cordova; - using WPCordovaClassLib.Cordova.Commands; - using WPCordovaClassLib.Cordova.JSON; - -4. Extend your class from BaseCommand - - public class Echo : BaseCommand - { - // ... - } - -5. Add a method that is callable from JS - - public class Echo : BaseCommand - { - public void echo(string options) - { - // all JS callable plugin methods MUST have this signature! - // public, returning void, 1 argument that is a string - } - } - -Namespaces ----------- - -The default namespace for unqualified commands is: - - namespace Cordova.Extension.Commands - { - // ... - } - -If you would like to use your own namespace, you will need to make a fully qualified -call to `cordova.exec`. For example, if you wanted to define your C# class like this: - - namespace com.mydomain.cordovaExtensions - { - public class Echo : BaseCommand - { - // ... - } - } - -Then, in JS you would need to call exec like this: - - cordova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...); - -Interpreting your arguments in C# ----------------------------------- - -The data received by your plugin method is a string value, but in actuality -looking at our JavaScript code, we see our intention was to pass an array of strings. -Looking back at our JS call to `cordova.exec`, we see we passed `[str]`: - - cordova.exec(win, fail, "Echo", "echo", ["input string"]); - -If we inspect the options string passed in to our `Echo.echo` method, we will -see that the value is actually: - - "[\"input string\"]" - -All javascript exec arguments are JSON encoded before being passed into C#. - -If we want to treat this as the string we were expecting, we need to decode it. -We can use simple JSON deserialization. - - string optVal = JsonHelper.Deserialize<string[]>(options)[0]; - // optVal now has the value of "input string" - -Passing results from C# to JS ------------------------------ - -The base class BaseCommand provides methods for passing data to your JS callback handlers. -To simply signal that the command has succeeded, when no additional result info is needed, -you can can simply call: - - DispatchCommandResult(); // calls back with an empty plugin result, considered a success callback - -To pass data back, you will need to call a different version of `DispatchCommandResult`: - - DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Everything went as planned, this is a result that is passed to the success handler.")); - -To pass structured object data back to JS, it should be encoded as a JSON string: - - DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"super awesome!\"}")); - -If you need to signal that an error has occurred, you can call `DispatchCommandResult` with a `PluginResult` object: - - DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo signaled an error")); - -Handling serialization errors in your plugin's C# method --------------------------------------------------------- - -When interpreting your arguments, it is a good idea to use a try/catch block -in case we have bad input. This is a pattern used throughout the Cordova C# code: - - string optVal = null; - - try - { - optVal = JsonHelper.Deserialize<string[]>(options)[0]; - } - catch(Exception) - { - // simply catch the exception, we will handle null values and exceptions together - } - - if (optVal == null) - { - DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION)); - } - else - { - // ... continue on to do our work - } - -Advanced Plugin Functionality ------------------------------ - -See other methods that you can override in: - -1. [BaseCommand.cs](https://github.com/apache/cordova-wp7/blob/master/templates/standalone/cordovalib/Commands/BaseCommand.cs) - -For example, you can hook into the 'pause' and 'resume' application events. - -### Debugging Plugins - -To debug the C# side, you can use Visual Studio's debugger, just set a break point -at any of the methods exposed by your class. - -Javascript is a little more difficult to debug on Windows Phone, you will need to -use `console.log` to output the state of your plugin, or inform yourself of errors. - -Common Pitfalls ---------------- - -- Be careful when deciding on the arguments you pass to native in your JavaScript - implementation. Most device platforms expect the args passed to cordova.exec - to be an array, but if you have different types of objects in this array, it - becomes difficult or impossible to deserialize. - - cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", 54, {literal:'trouble'}]); - - - This will mean that your C# code will receive a difficult to decode string value, such as: - - "[\"this is a string\", 54, { literal:'trouble' }]" - - - Consider converting ALL parameters to strings before calling exec: - - cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", "54", "{literal:'trouble'}"]) ; - - string[] optValues = JsonHelper.Deserialize<string[]>(options); - -- It is usually a good idea to do parameter checking in your JavaScript code, - before you call exec. This will let you re-use more JS code between different - native implementations of your plugin. -
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/privacy/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/privacy/index.md b/docs/en/2.8.0rc1/guide/privacy/index.md deleted file mode 100644 index 1731700..0000000 --- a/docs/en/2.8.0rc1/guide/privacy/index.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -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. ---- - -Privacy Guide -============= - -Mobile privacy is a critical issue that every app developer must address. Your users expect that their private information will be collected and treated appropriately by your app. Also, there are an increasing number of jurisdictions that now have legal requirements regarding mobile privacy practices. - -This guide on mobile app privacy should be considered a "primer" addressing some the most significant issues. It outlines some broadly accepted best practices and provides references to other more detailed guides and references. - -* Privacy Policy. - - You app should include a privacy policy that addresses topics such as what kind of information your app collects from or about your users, how that information is used, with whom it is shared, and how users can make privacy-related choices within the app. To aid understanding, you should use plain language and avoid technical jargon. You should make your privacy policy available for users to review prior to download, such as in the app description in the app marketplace. In addition, you should make your privacy policy available within the app itself. The limited size of mobile device displays creates challenges for displaying privacy policies to users. Consider developing a "short form" of the policy that includes the most important information, and then provide a link to the "long form" policy for those interested in more details. Several groups are attempting to develop icon-based standards for communicating privacy practices, which you may want to consider once these standar ds mature. - -* Collection of sensitive information. - - An app's collection of sensitive personal information raises important privacy concerns. Examples of sensitive personal information include financial information, health information, and information from or about children. It also includes information gathered from certain sensors and databases typically found on mobile devices and tablets, such as geolocation information, contacts/phonebook, microphone/camera, and stored pictures/videos. See the following documentation pages for more information: [camera](cordova_camera_camera.md.html), [capture](cordova_media_capture_capture.md.html), [contacts](cordova_contacts_contacts.md.html), and [geolocation](cordova_geolocation_geolocation.md.html). Generally, you should obtain a user's express permission before collecting sensitive information and, if possible, provide a control mechanism that allows a user to easily change permissions. App operating systems can help in some instances by presenting just-in-time dialog boxes that ask fo r the user's permission before collection. In these cases, be sure to take advantage of any opportunity to customize the dialog box text to clarify how the app uses and, if applicable, shares such information. - -* Avoiding user surprise. - - If your app collects or uses information in a way that may be surprising to users in light of the primary purpose of your app (for example, a music player that accesses stored pictures), you should take similar steps as with the collection of sensitive personal information. That is, you should strongly consider the use of just-in-time dialog boxes to inform the user about the collection or use of that information and, if appropriate, provide a corresponding privacy control. - -* Third party data collection or sharing. - - If you app collects information that is provided to another company -- such as a social networking platform or an ad network (for example, if your app displays advertising) -- you should inform your users of that collection and sharing. At a minimum, your privacy policy should describe the information collection and sharing and, if appropriate, offer your users the ability to control or opt-out of such collection or sharing. - -* Collection limitation and security. - - Your users entrust your app with their information and they expect that you will take appropriate security precautions to protect it. One of the best ways to avoid security compromises of personal information is not to collect the information in the first place unless your app has a specific and legitimate business reason for the collection. For information that does need to be collected, ensure that you provide appropriate security controls to protect that information, whether it is stored on the device or on your backend servers. You should also develop an appropriate data retention policy that is implemented within the app and on your backend servers. - -Following are some additional helpful mobile privacy guides for developers: - -* California Attorney General, [Privacy on the Go: Recommendations for the Mobile Ecosystem][1] - -* Center for Democracy & Technology, Future of Privacy Forum, [Best Practices for Mobile App Developers][2] - -* CTIA-The Wireless Association, [Best Practices and Guidelines for Location Based Services][3] - -* Federal Trade Commission, [Mobile Privacy Disclosures: Building Trust Through Transparency][4] - -* Future of Privacy Forum, [Application Privacy][5] Website - -[1]: http://oag.ca.gov/sites/all/files/pdfs/privacy/privacy_on_the_go.pdf -[2]: http://www.futureofprivacy.org/wp-content/uploads/Best-Practices-for-Mobile-App-Developers_Final.pdf -[3]: http://www.ctia.org/business_resources/wic/index.cfm/AID/11300 -[4]: http://www.ftc.gov/os/2013/02/130201mobileprivacyreport.pdf -[5]: http://www.applicationprivacy.org http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/android/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/android/index.md b/docs/en/2.8.0rc1/guide/project-settings/android/index.md deleted file mode 100644 index 20b0ea1..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/android/index.md +++ /dev/null @@ -1,43 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for Android -=================================== - -The `config.xml` settings file controls various settings of Cordova. This is application wide, and not set per CordovaWebView Instance. - -## <preference> - -Various **other** preferences (as **<preference>** tags) default on not breaking existing apps. The available preferences are: - -1. **useBrowserHistory (boolean, defaults to true)** - set to false if you want to use the history shim that was used to work around the hashtag error present in Android 3.x prior to the history fix. (Note: This setting will be deprecated in April 2013) -2. **loadingDialog** - Display a native loading dialog when loading the app. Format for the value is "Title, Message" -3. **loadingPageDialog** - Display a native loading dialog when loading sub-pages. Format for the value is "Title, Message" -4. **errorUrl** - Set the error page for your application. Should be located in your Android project in file://android_asset/www/ -5. **backgroundColor** - Set the background color for your application. Supports a four-byte hex value, with the first byte representing alpha value, and the following three bytes with standard RGB values. (i.e. 0x00000000 = Black) -6. **loadUrlTimeoutValue** - How much time Cordova should wait before throwing a timeout error on the application. -7. **keepRunning (boolean, defaults to true)** - Determines whether Cordova will keep running in the background or not -8. **splashscreen** - The name of the file minus its extension in the res/drawable directory. If you have multiple assets, they all must share this common name in their respective directories. -9. **disallowOverscroll (boolean, defaults to false)** - set to true if you want to disable the glow when a user scrolls beyond the edge of the webview. - -## <plugin> - -Android supports using <feature> as analogues to <plugin> elements. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/bada/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/bada/index.md b/docs/en/2.8.0rc1/guide/project-settings/bada/index.md deleted file mode 100644 index f5507d9..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/bada/index.md +++ /dev/null @@ -1,24 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for Bada -=================================== - http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/blackberry/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/blackberry/index.md b/docs/en/2.8.0rc1/guide/project-settings/blackberry/index.md deleted file mode 100644 index c08e3fe..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/blackberry/index.md +++ /dev/null @@ -1,25 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for BlackBerry -=================================== - -BlackBerry has full support for the [W3C Widget Specfication](http://www.w3.org/TR/widgets/) as well as proprietary RIM extensions. Please see the full [BlackBerry WebWorks documentation regarding config.xml](https://developer.blackberry.com/html5/documentation/working_with_config_xml_file_1866970_11.html) for details. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/firefoxos/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/firefoxos/index.md b/docs/en/2.8.0rc1/guide/project-settings/firefoxos/index.md deleted file mode 100644 index 89f53b8..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/firefoxos/index.md +++ /dev/null @@ -1,24 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for FirefoxOS -=================================== - http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/index.md b/docs/en/2.8.0rc1/guide/project-settings/index.md deleted file mode 100644 index 3dfb4f5..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/index.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -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. ---- - -Project Settings -================ - -You can set various application configuration parameters using a platform-agnostic configuration file, `config.xml`. -This file is based on the W3C [Packaged Web Apps (Widgets)](http://www.w3.org/TR/widgets/) specification. - -The location of the `config.xml` file is different depending on the platform. The contents, in general, are not. - -## Platform-Specific Properties - -As with any abstraction layer, Apache Cordova cannot be a perfect silver bullet. As such, some native and platform-specific -properties, characteristics and behaviours are encapsulated as much as possible as `<preference>` elements inside the -`config.xml` file. The following sub-sections linked to are guides which go into more details about these preferences. - -- Project Settings for iOS -- Project Settings for Android -- Project Settings for BlackBerry -- Project Settings for Windows Phone 7 -- Project Settings for Windows Phone 8 -- Project Settings for Windows 8 -- Project Settings for webOS -- Project Settings for Bada -- Project Settings for FirefoxOS - -## config.xml Elements - -The [Apache Cordova](http://cordova.io) project strives abstract away native platform specifics via web-inspired and web-based -abstractions that are heavily standards driven and adopted by the web community. Please take a few minutes to familiarize -yourself with the [config.xml specification](http://www.w3.org/TR/widgets/), to understand the type of application metadata the -Apache Cordova project aims to abstract and provide simple entry points for. - -An example: - - <widget> - <preference name="MySetting" value="true" /> - <plugins> - <plugin name="MyPlugin" value="MyPluginClass" /> - </plugins> - <access origin="*" /> - </widget> - -A list of supported elements across major platforms which are supported in Apache Cordova follow. - -### `<plugin>` - -These elements map to native APIs that the application will be able to access. At runtime, the Apache Cordova framework checks -the `<plugin>` elements and maps them to native code to enable your Cordova application to access device APIs otherwise -unavailable to typical web-based applications. - -### `<access>` - -These elements define how your whitelist works. Please see the Domain Whitelist Guide for more information. - -### `<content>` - -This element defines the start page of your application, relative to the project's standard web assets root folder. The default is "index.html". http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/ios/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/ios/index.md b/docs/en/2.8.0rc1/guide/project-settings/ios/index.md deleted file mode 100644 index a401f10..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/ios/index.md +++ /dev/null @@ -1,60 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for iOS -======================== - -The `config.xml` settings file controls various settings of Cordova. This is application wide, and not set per CDVViewController instance. -The `config.xml` file is located in your `<project folder>/<appname>` directory. - -## <preference> - -Various preferences (as **<preference>** tags) default on not breaking existing apps. The available preferences are: - -1. **DisallowOverscroll (boolean, defaults to false)** - set to true if you don't want the WebView to rubber-band - -2. **TopActivityIndicator (string, defaults to 'gray')** - this is the top spinning throbber in the status/battery bar, valid values are "whiteLarge", "white" and "gray" - -3. **EnableLocation (boolean, defaults to false)** - set to true, to initialize the Geolocation plugin at start-up (so the fix on your location can be more accurate) **DEPRECATED**: please set the **onload** attribute of the **Geolocation** plugin to **true** instead. - -4. **EnableViewportScale (boolean, defaults to false)** - set to true to prevent viewport scaling through a meta tag - -5. **AutoHideSplashScreen (boolean, defaults to true)** - set to false to control when the splashscreen is hidden through a JavaScript API - -6. **FadeSplashScreen (boolean, defaults to true)** - set to false to prevent the splash-screen to fade in and out when showing/hiding it. - -7. **FadeSplashScreenDuration (float, defaults to 2)** - The splash-screen Fade duration in seconds. - -8. **ShowSplashScreenSpinner (boolean, defaults to true)** - set to false to hide the splash-screen spinner - -9. **MediaPlaybackRequiresUserAction (boolean, defaults to false)** - set to true to not allow autoplayed HTML5 video - -10. **AllowInlineMediaPlayback (boolean, defaults to false)** - set to true to allow inline HTML5 media playback, also, the video element in the HTML document must also include the webkit-playsinline attribute - -11. **BackupWebStorage (string, defaults to 'cloud')** - valid values are 'none', 'cloud' and 'local'. Set to 'cloud' to allow the web storage data to be backed up to iCloud, and set to 'local' to only allow local backups (iTunes sync). Set to 'none' to not allow any backups of web storage. - -12. **KeyboardDisplayRequiresUserAction (boolean, defaults to true)** - set to false to open the keyboard when form elements get focus via the JavaScript focus() call. - -13. **SuppressesIncrementalRendering (boolean, defaults to false)** - set to true to wait until all new view content has been received before it is rendered. - -14. **HideKeyboardFormAccessoryBar (boolean, defaults to false)** - set to true to hide the additional toolbar that is on top of the keyboard (this is the toolbar that has the Prev, Next and Done buttons) - -15. **KeyboardShrinksView (boolean, defaults to false)** - set to true to shrink the WebView when the keyboard comes up. The WebView shrinks instead of the viewport shrinking and the page scrollable. This applies to apps that position their elements relative to the bottom of the WebView. This is the default behaviour on Android, and makes a lot of sense when building apps as opposed to webpages. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/webos/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/webos/index.md b/docs/en/2.8.0rc1/guide/project-settings/webos/index.md deleted file mode 100644 index bd47e17..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/webos/index.md +++ /dev/null @@ -1,25 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for webOS -=================================== - -WebOS does not currently have any additional configurable features. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/windows8/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/windows8/index.md b/docs/en/2.8.0rc1/guide/project-settings/windows8/index.md deleted file mode 100644 index e38dbbb..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/windows8/index.md +++ /dev/null @@ -1,26 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for Windows 8 -=================================== - -Windows 8 does not currently support this feature. - http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/wp7/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/wp7/index.md b/docs/en/2.8.0rc1/guide/project-settings/wp7/index.md deleted file mode 100644 index 9c4a410..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/wp7/index.md +++ /dev/null @@ -1,25 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for Windows Phone 7 -=================================== - -Windows Phone 7 does not currently have any additional configurable features. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/project-settings/wp8/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/project-settings/wp8/index.md b/docs/en/2.8.0rc1/guide/project-settings/wp8/index.md deleted file mode 100644 index 7d9ca64..0000000 --- a/docs/en/2.8.0rc1/guide/project-settings/wp8/index.md +++ /dev/null @@ -1,25 +0,0 @@ -<!-- -# -# 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. -# ---> - -Project Settings for Windows Phone 8 -=================================== - -Windows Phone 8 does not currently have any additional configurable features. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/upgrading/android/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/upgrading/android/index.md b/docs/en/2.8.0rc1/guide/upgrading/android/index.md deleted file mode 100644 index 143ab1c..0000000 --- a/docs/en/2.8.0rc1/guide/upgrading/android/index.md +++ /dev/null @@ -1,231 +0,0 @@ ---- -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. ---- - -Upgrading Cordova Android -========================= - - -This document is for people who need to upgrade their Cordova versions from an older version to a current version of Cordova. - -## Upgrade to 2.8.0 from 2.7.0 ## -1. Run bin/update <project> with the project path listed in the Cordova Source directory - -## Upgrade to 2.7.0 from 2.6.0 ## -1. Run bin/update <project> with the project path listed in the Cordova Source directory - -## Upgrade to 2.6.0 from 2.5.0 ## -1. Run bin/update <project> with the project path listed in the Cordova Source directory - -## Upgrade to 2.5.0 from 2.4.0 ## - -1. Remove cordova-2.4.0.jar from the libs directory in your project -2. Add cordova-2.5.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.5.0.js into your project -5. Update your HTML to use the new cordova-2.5.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml -7. Update framework/res/xml/config.xml to have similar settings as it did previously -8. Copy files from bin/templates/cordova to the cordova directory in your project - -## Upgrade to 2.4.0 from 2.3.0 ## - -1. Remove cordova-2.3.0.jar from the libs directory in your project -2. Add cordova-2.4.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.4.0.js into your project -5. Update your HTML to use the new cordova-2.4.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml -7. Copy files from bin/templates/cordova to the cordova directory in your project - - -## Upgrade to 2.3.0 from 2.2.0 ## - -1. Remove cordova-2.2.0.jar from the libs directory in your project -2. Add cordova-2.3.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.3.0.js into your project -5. Update your HTML to use the new cordova-2.3.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml -7. Copy files from bin/templates/cordova to the cordova directory in your project - -## Upgrade to 2.2.0 from 2.1.0 ## - -1. Remove cordova-2.1.0.jar from the libs directory in your project -2. Add cordova-2.2.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.2.0.js into your project -5. Update your HTML to use the new cordova-2.2.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml -7. Copy files from bin/templates/cordova to the cordova directory in your project - - -## Upgrade to 2.1.0 from 2.0.0 ## - -1. Remove cordova-2.0.0.jar from the libs directory in your project -2. Add cordova-2.1.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.1.0.js into your project -5. Update your HTML to use the new cordova-2.1.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml -7. Copy files from bin/templates/cordova to the cordova directory in your project - - -## Upgrade to 2.0.0 from 1.9.0 ## - -1. Remove cordova-1.9.0.jar from the libs directory in your project -2. Add cordova-2.0.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-2.0.0.js into your project -5. Update your HTML to use the new cordova-2.0.0.js file -6. Copy the res/xml/config.xml to be the same as the one found in framework/res/xml/config.xml - -### Notes about 2.0.0 release -config.xml will be replacing cordova.xml and plugins.xml. This new file is a combination of the previous two. However, the -old files are deprecated, and and while currently still work, will cease working in a future release. - -## Upgrade to 1.9.0 from 1.8.1 ## - -1. Remove cordova-1.8.0.jar from the libs directory in your project -2. Add cordova-1.9.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.9.0.js into your project -5. Update your HTML to use the new cordova-1.9.0.js file -6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - -### Notes about 1.9.0 release - -- Third-Party plugins may or may not work. This is because of the introduction of the CordovaWebView. These plugins need to get a context from the CordovaInterface using -getContext() or getActivity(). If you are not an experienced Android developer, please contact the plugin maintainer and add this task to their bug tracker. - -## Upgrade to 1.8.0 from 1.8.0 ## - -1. Remove cordova-1.8.0.jar from the libs directory in your project -2. Add cordova-1.8.1.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.8.1.js into your project -5. Update your HTML to use the new cordova-1.8.1.js file -6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - - -## Upgrade to 1.8.0 from 1.7.0 ## - -1. Remove cordova-1.7.0.jar from the libs directory in your project -2. Add cordova-1.8.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.8.0.js into your project -5. Update your HTML to use the new cordova-1.8.0.js file -6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - - - - -## Upgrade to 1.8.0 from 1.7.0 ## - -1. Remove cordova-1.7.0.jar from the libs directory in your project -2. Add cordova-1.8.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.8.0.js into your project -5. Update your HTML to use the new cordova-1.8.0.js file -6. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - - -## Upgrade to 1.7.0 from 1.6.1 ## - -1. Remove cordova-1.6.1.jar from the libs directory in your project -2. Add cordova-1.7.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.7.0.js into your project -5. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - - -## Upgrade to 1.6.1 from 1.6.0 ## - -1. Remove cordova-1.6.0.jar from the libs directory in your project -2. Add cordova-1.6.1.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.6.1.js into your project -5. Update the res/xml/plugins.xml to be the same as the one found in framework/res/xml/plugins.xml - -## Upgrade to 1.6.0 from 1.5.0 ## -1. Remove cordova-1.5.0.jar from the libs directory in your project -2. Add cordova-1.6.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.6.0.js into your project -5. Update your HTML to use the new cordova-1.6.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml -7. Replace the res/xml/phonegap.xml with res/xml/cordova.xml so that it is the same as the one found in framework/res/xml/cordova.xml - - -## Upgrade to 1.5.0 from 1.4.0## -1. Remove phonegap-1.4.0.jar from the libs directory in your project -2. Add cordova-1.5.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new cordova-1.5.0.js into your project -5. Update your HTML to use the new cordova-1.5.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml -7. Replace the res/xml/phonegap.xml with res/xml/cordova.xml so that it is the same as the one found in framework/res/xml/cordova.xml - -## Upgrade to 1.4.0 from 1.3.0 ## -1. Remove phonegap-1.3.0.jar from the libs directory in your project -2. Add phonegap-1.4.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new phonegap-1.4.0.js into your project -5. Update your HTML to use the new phonegap-1.4.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml -7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml - - -## Upgrade to 1.3.0 from 1.2.0 ## -1. Remove phonegap-1.2.0.jar from the libs directory in your project -2. Add phonegap-1.3.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new phonegap-1.3.0.js into your project -5. Update your HTML to use the new phonegap-1.2.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml -7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml - - -## Upgrade to 1.2.0 from 1.1.0 ## -1. Remove phonegap-1.1.0.jar from the libs directory in your project -2. Add phonegap-1.2.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new phonegap-1.2.0.js into your project -5. Update your HTML to use the new phonegap-1.2.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml -7. Update the res/xml/phonegap.xml so that it is the same as the one found in framework/res/xml/phonegap.xml - - -## Upgrade to 1.1.0 from 1.0.0 ## -1. Remove phonegap-1.0.0.jar from the libs directory in your project -2. Add phonegap-1.1.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new phonegap-1.1.0.js into your project -5. Update your HTML to use the new phonegap-1.1.0.js file -6. Update the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml - - -## Upgrade to 1.0.0 from 0.9.6 ## -1. Remove phonegap-0.9.6.jar from the libs directory in your project -2. Add phonegap-1.0.0.jar to the libs directory in your project -3. If you are using Eclipse, please refresh your eclipse project and do a clean -4. Copy the new phonegap-1.0.0.js into your project -5. Update your HTML to use the new phonegap-1.0.0.js file -6. Add the res/xml/plugins.xml so that it is the same as the one found in framework/res/xml/plugins.xml - - http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/upgrading/bada/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/upgrading/bada/index.md b/docs/en/2.8.0rc1/guide/upgrading/bada/index.md deleted file mode 100644 index 52d73ab..0000000 --- a/docs/en/2.8.0rc1/guide/upgrading/bada/index.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -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. ---- - -Upgrading Cordova Bada -====================== - -This document is for people who need to upgrade their Cordova versions from an -older version to a current version of Cordova. - -## Upgrade to 1.9.0 from 2.0.0 ## - -1. Update `Res/js/cordova.js` with the new JavaScript file. - -## Upgrade to 1.9.0 from 1.8.x ## - -1. Update `Res/js/cordova.js` with the new JavaScript file. - -## Upgrade to 1.8.x from 1.7.0 ## - -1. Remove the cordova.bada.js file from the Res/js directory -2. Add the new cordova.js file to your Res/js directory -3. Update your Res/index.html to reference cordova.js instead of cordova.bada.js - -Change this line: - - <script type="text/javascript" src="./js/cordova.bada.js"></script> -to: - - <script type="text/javascript" src="./js/cordova.js"></script> - -As of Cordova 1.8, Bada 1.2 is no longer supported! The repository will be kept -there as an archive for people who still want to use it. It contains some outdated APIs. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/upgrading/blackberry/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/upgrading/blackberry/index.md b/docs/en/2.8.0rc1/guide/upgrading/blackberry/index.md deleted file mode 100644 index e7853e6..0000000 --- a/docs/en/2.8.0rc1/guide/upgrading/blackberry/index.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -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. ---- - -Upgrading Cordova BlackBerry -============================ - -This document is for people who need to upgrade their Cordova versions from an older version to a current version of Cordova. - -## Upgrade to 2.0.0 from 1.9.0 ## - -Updating just the www folder: - -1. Open your `www/` folder, which contains your app. -2. Remove and update the .jar file in the `ext/` folder. -3. Update the contents of the `ext-air/` folder. -4. Copy the new `cordova-2.0.0.js` into your project. - - If playbook, then update the .js file in the `playbook/` folder. -5. Update your HTML to use the new `cordova-2.0.0.js` file. -6. Update your `www/plugins.xml` file. Two plugins changed their - namespace/service label. Change the old entries for the Capture and - Contact plugins from: - - <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> - <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> - - To: - - <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> - <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> - - -Updating the sample folder (ie, updating using the ant tools): - -1. Open the `sample/lib/` folder. -2. Update the .jar file in the `cordova.1.9.0/ext/` folder. -3. Update the contents of the `cordova.1.9.0/ext-air/` folder. -4. Update the .js file in the `cordova.1.9.0/javascript/` folder. -5. Open the `sample/lib/` folder and rename the `cordova.1.9.0/` folder to `cordova.2.0.0/`. -6. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. -7. Open the `www/` folder and update your HTML to use the new `cordova-2.0.0.js` file. -8. Open the `www/` folder and update the `plugins.xml` file. Two plugins - changed their namespace/service label. Change the old entries for the - Capture and Contact plugins from: - - <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> - <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> - - To: - - <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> - <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> - - - - -- To upgrade to 1.8.0, please go from 1.7.0 - -## Upgrade to 1.8.0 from 1.7.0 ## - -Updating just the www folder: - -1. Open your `www/` folder, which contains your app. -2. Remove and update the .jar file in the `ext/` folder. -3. Update the contents of the `ext-air/` folder. -4. Copy the new `cordova-1.8.0.js` into your project. - - If playbook, then update the .js file in the `playbook/` folder. -5. Update your HTML to use the new `cordova-1.8.0.js` file. -6. Update your `www/plugins.xml` file. Two plugins changed their - namespace/service label. Change the old entries for the Capture and - Contact plugins from: - - <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> - <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> - - To: - - <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> - <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> - - -Updating the sample folder (ie, updating using the ant tools): - -1. Open the `sample/lib/` folder. -2. Update the .jar file in the `cordova.1.7.0/ext/` folder. -3. Update the contents of the `cordova.1.7.0/ext-air/` folder. -4. Update the .js file in the `cordova.1.7.0/javascript/` folder. -5. Open the `sample/lib/` folder and rename the `cordova.1.7.0/` folder to `cordova.1.8.0/`. -6. Type `ant blackberry build` or `ant playbook build` to update the `www/` folder with updated Cordova. -7. Open the `www/` folder and update your HTML to use the new `cordova-1.8.0.js` file. -8. Open the `www/` folder and update the `plugins.xml` file. Two plugins - changed their namespace/service label. Change the old entries for the - Capture and Contact plugins from: - - <plugin name="Capture" value="org.apache.cordova.media.MediaCapture"/> - <plugin name="Contact" value="org.apache.cordova.pim.Contact"/> - - To: - - <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture"/> - <plugin name="Contacts" value="org.apache.cordova.pim.Contact"/> - http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/bb951076/docs/en/2.8.0rc1/guide/upgrading/index.md ---------------------------------------------------------------------- diff --git a/docs/en/2.8.0rc1/guide/upgrading/index.md b/docs/en/2.8.0rc1/guide/upgrading/index.md deleted file mode 100644 index 009d554..0000000 --- a/docs/en/2.8.0rc1/guide/upgrading/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -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. ---- - -Upgrading Guides -================ - -> Learn how to upgrade an application to the latest Apache Cordova release. - -- Upgrading Cordova Android -- Upgrading Cordova BlackBerry -- Upgrading Cordova iOS -- Upgrading Cordova Symbian -- Upgrading Cordova webOS -- Upgrading Cordova Windows Phone -- Upgrading Cordova Bada -- Upgrading Cordova Tizen
