You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/12/05 04:38:50 UTC
ios commit: Updated doc references to Cordova.plist,
use new config.xml
Updated Branches:
refs/heads/master 8d1e52fd6 -> d00dc78e1
Updated doc references to Cordova.plist, use new config.xml
Project: http://git-wip-us.apache.org/repos/asf/cordova-ios/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-ios/commit/d00dc78e
Tree: http://git-wip-us.apache.org/repos/asf/cordova-ios/tree/d00dc78e
Diff: http://git-wip-us.apache.org/repos/asf/cordova-ios/diff/d00dc78e
Branch: refs/heads/master
Commit: d00dc78e1c4f425014fb4717cce581176c60aebd
Parents: 8d1e52f
Author: Shazron Abdullah <sh...@apache.org>
Authored: Tue Dec 4 19:38:20 2012 -0800
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Tue Dec 4 19:38:20 2012 -0800
----------------------------------------------------------------------
CordovaLibTests/CordovaLibApp/www/index.html | 2 +-
FirstRun.md | 15 ++++++++-------
README.md | 5 ++---
3 files changed, 11 insertions(+), 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-ios/blob/d00dc78e/CordovaLibTests/CordovaLibApp/www/index.html
----------------------------------------------------------------------
diff --git a/CordovaLibTests/CordovaLibApp/www/index.html b/CordovaLibTests/CordovaLibApp/www/index.html
index f7ffdf0..1cac0a4 100644
--- a/CordovaLibTests/CordovaLibApp/www/index.html
+++ b/CordovaLibTests/CordovaLibApp/www/index.html
@@ -78,7 +78,7 @@
<h1>Hey, it's Cordova!</h1>
<ol>
<li>Check your console log for any white-list rejection errors.</li>
- <li>Add your allowed <strong>hosts</strong> in Cordova.plist/ExternalHosts (wildcards OK, don't enter the URL scheme)</li>
+ <li>Add your allowed <strong>hosts</strong> in config.xml as access tags and set the origin attribute. (wildcards OK, don't enter the URL scheme)</li>
</ol>
</body>
</html>
http://git-wip-us.apache.org/repos/asf/cordova-ios/blob/d00dc78e/FirstRun.md
----------------------------------------------------------------------
diff --git a/FirstRun.md b/FirstRun.md
index eb866f3..9d5456d 100644
--- a/FirstRun.md
+++ b/FirstRun.md
@@ -22,10 +22,15 @@
## Plugins
-* Plugins **MUST** add their plugin mapping to their app's Cordova.plist Plugins key, if not they will not work (see your plugin's README)
-* Plugins **MUST** add any external hosts they connect to to the white-list in Cordova.plist/ExternalHosts (add hostnames **only**, NO protocols nor paths) - see the [**Domain Whitelist Guide**](http://docs.cordova.io/en/edge/guide_whitelist_index.md.html#Domain%20Whitelist%20Guide)
+* Plugins **MUST** add their plugin mapping to under their app's **config.xml** <plugins> key, see your plugin's README e.g.
+
+ <plugin name="MyPluginName" value="MyPluginClass" />
+
+* Plugins **MUST** add any external hosts they connect to to the white-list in config.xml - see the [**Domain Whitelist Guide**](http://docs.cordova.io/en/edge/guide_whitelist_index.md.html#Domain%20Whitelist%20Guide), e.g.
+
+ <access origin="www.apache.org" />
+
* A plugin's Objective-C code **MUST** be added to the project properly in a "group" (**YELLOW** folder), if you incorrectly added it as a folder reference it would be a blue folder (just delete the reference, and re-add)
-* A lot of plugins have changed their mapping names in **Cordova.plist**, you might have to copy and use the new **Cordova.plist** in your app.
<br />
@@ -42,10 +47,6 @@ Please see the **Cordova Plugin Upgrade Guide.md** document included in the **gu
<br />
-## Install CordovaLib
-
-Please see the instructions in the **README.md** document included in the source distribution
-
## Creating a new Cordova-based project
Follow the instructions in the [**Command-Line Usage** section](http://docs.cordova.io/en/edge/guide_command-line_index.md.html#Command-Line%20Usage) of [http://docs.cordova.io](http://docs.cordova.io)
http://git-wip-us.apache.org/repos/asf/cordova-ios/blob/d00dc78e/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index d853569..3f43e26 100644
--- a/README.md
+++ b/README.md
@@ -120,7 +120,7 @@ Check your Xcode Console Log for clues.
This can be because of:
-1. You did not add the plugin mapping in __Cordova.plist/Plugins__ (contact the plugin creator for the proper mapping). The __key__ is the service name used in the JavaScript interface and the __value__ is the classname used in the Objective-C interface. Often the key and value are the same.
+1. You did not add the plugin mapping in __config.xml/<plugins>__ (contact the plugin creator for the proper mapping). Add a new child __<plugin>__ tag. The __name__ attribute is the service name used in the JavaScript interface and the __value__ attribute is the classname used in the Objective-C interface. Often the name and value are the same.
2. You did _not_ add the plugin code as a "group" (__yellow__ folder) but added it as a "folder reference" (blue folder)
3. You are having #import problems - see the [Upgrading Cordova iOS](http://docs.cordova.io/en/edge/guide_upgrading_index.md.html) document
@@ -130,13 +130,12 @@ This can be because of:
This error occurs because of the new white-list feature in version 1.1.
-You will have to add any hosts your app uses or connects to (hostnames/IP addresses only, **without** the protocol nor the path) in __Cordova.plist/ExternalHosts__. Wildcards are supported.
+You will have to add any hosts your app uses or connects to in __config.xml__ as an __<access>__ tag, and set the __origin___ attribute. Wildcards are supported.
This includes external http/https/ftp/ftps links in:
1. HTML anchor tags
2. connections in JavaScript (i.e through XMLHttpRequest)
-3. connections through Objective-C plugins
<br />