You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ia...@apache.org on 2013/10/02 06:12:20 UTC
docs commit: CB-4093: Add note for iOS about 3.1.0 changes
Updated Branches:
refs/heads/master dbf16c95e -> 7cf9fea03
CB-4093: Add note for iOS about 3.1.0 changes
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7cf9fea0
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7cf9fea0
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7cf9fea0
Branch: refs/heads/master
Commit: 7cf9fea03d7d02a13aef97a09a459e8128bd3198
Parents: dbf16c9
Author: Ian Clelland <ic...@chromium.org>
Authored: Wed Oct 2 00:11:50 2013 -0400
Committer: Ian Clelland <ic...@chromium.org>
Committed: Wed Oct 2 00:11:50 2013 -0400
----------------------------------------------------------------------
docs/en/3.1.0/guide/appdev/whitelist/index.md | 12 ++++++++++++
docs/en/edge/guide/appdev/whitelist/index.md | 12 ++++++++++++
2 files changed, 24 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7cf9fea0/docs/en/3.1.0/guide/appdev/whitelist/index.md
----------------------------------------------------------------------
diff --git a/docs/en/3.1.0/guide/appdev/whitelist/index.md b/docs/en/3.1.0/guide/appdev/whitelist/index.md
index fc816d0..b288561 100644
--- a/docs/en/3.1.0/guide/appdev/whitelist/index.md
+++ b/docs/en/3.1.0/guide/appdev/whitelist/index.md
@@ -123,6 +123,18 @@ The whitelisting rules are found in `AppName/config.xml` and declared with the e
iOS fully supports whitelisting syntax.
+### Changed in 3.1.0:
+
+Prior to version 3.1.0, Cordova-iOS included some non-standard extensions to the domain whilelisting scheme supported by other Cordova platforms. As of 3.1.0, the iOS whitelist now conforms to the resource whitelist syntax described at the top of this document. If you upgrade from pre-3.1.0, and you were using these extensions, you may have to change your `config.xml` file in order to continue whitelisting the same set of resources as before.
+
+Specifically, these patterns need to be updated:
+
+ * "`apache.org`" (no protocol): This would previously match `http`, `https`, `ftp`, and `ftps` protocols. Change to "`*://apache.org/*`" to include all protocols, or include a line for each protocol you need to support.
+
+ * "`http://apache.*`" (wildcard at end of domain): This would previously match all top-level-domains, including all possible two-letter TLDs (but not useful domains like .co.uk). Include a line for each TLD which you actually control, and need to whitelist.
+
+ * "`h*t*://ap*he.o*g`" (wildcards for random missing letters): These are no longer supported; change to include a line for each domain and protocol that you actually need to whitelist.
+
### Syntax
Access to [google.com][2]:
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7cf9fea0/docs/en/edge/guide/appdev/whitelist/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/appdev/whitelist/index.md b/docs/en/edge/guide/appdev/whitelist/index.md
index fc816d0..b288561 100644
--- a/docs/en/edge/guide/appdev/whitelist/index.md
+++ b/docs/en/edge/guide/appdev/whitelist/index.md
@@ -123,6 +123,18 @@ The whitelisting rules are found in `AppName/config.xml` and declared with the e
iOS fully supports whitelisting syntax.
+### Changed in 3.1.0:
+
+Prior to version 3.1.0, Cordova-iOS included some non-standard extensions to the domain whilelisting scheme supported by other Cordova platforms. As of 3.1.0, the iOS whitelist now conforms to the resource whitelist syntax described at the top of this document. If you upgrade from pre-3.1.0, and you were using these extensions, you may have to change your `config.xml` file in order to continue whitelisting the same set of resources as before.
+
+Specifically, these patterns need to be updated:
+
+ * "`apache.org`" (no protocol): This would previously match `http`, `https`, `ftp`, and `ftps` protocols. Change to "`*://apache.org/*`" to include all protocols, or include a line for each protocol you need to support.
+
+ * "`http://apache.*`" (wildcard at end of domain): This would previously match all top-level-domains, including all possible two-letter TLDs (but not useful domains like .co.uk). Include a line for each TLD which you actually control, and need to whitelist.
+
+ * "`h*t*://ap*he.o*g`" (wildcards for random missing letters): These are no longer supported; change to include a line for each domain and protocol that you actually need to whitelist.
+
### Syntax
Access to [google.com][2]: