You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by riknoll <gi...@git.apache.org> on 2016/02/06 02:23:57 UTC

[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

GitHub user riknoll opened a pull request:

    https://github.com/apache/cordova-docs/pull/490

    CB-10206: Documenting uses-sdk attribute support in config.xml

    And stripped a lot of trailing whitespace. I recommend you append `?w=1` to the URL (lets you view diff without whitespace changes)

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/riknoll/cordova-docs CB-10206

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/cordova-docs/pull/490.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #490
    
----
commit e8fff492077c8857195a107c95f88ff91f1e20a5
Author: riknoll <ri...@gmail.com>
Date:   2016-02-06T01:15:37Z

    CB-10206: Documenting uses-sdk attribute support in config.xml

----


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by omefire <gi...@git.apache.org>.
Github user omefire commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/490#discussion_r52268466
  
    --- Diff: www/docs/en/dev/config_ref/index.md ---
    @@ -131,82 +131,85 @@ platform. See [Icons and Splash Screens](images.html) for more information.
             <content src="startPage.html"></content>
         </widget>
     
    -    
    +
     ## access
    -   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Attributes(type) | Description
        ----------------- | ------------
    -   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with. 
    -   The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with.
    +   The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Examples:
     
         <widget ...>
             <access origin="*"></content>
         </widget>
    -    
    +
         <widget ...>
             <access origin="http://google.com"></content>
         </widget>
    -    
    -    
    +
    +
     ## allow-navigation
        Controls which URLs the WebView itself can be navigated to. Applies to top-level navigations only.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to. 
    +   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#navigation-whitelist) for details.
    -   
    +
        Examples:
    -   
    +
         <!-- Allow links to example.com -->
         <allow-navigation href="http://example.com/*" />
     
         <!-- Wildcards are allowed for the protocol, as a prefix to the host, or as a suffix to the path -->
         <allow-navigation href="*://*.example.com/*" />
    -   
    +
     ## allow-intent
        Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open. 
    +   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#intent-whitelist) for details.  
    -  
    +
        Examples:
    -   
    +
         <allow-intent href="http://*/*" />
         <allow-intent href="https://*/*" />
         <allow-intent href="tel:*" />
         <allow-intent href="sms:*" />
    -  
    +
     ## engine
        Specifies what platform to restore during a prepare. For more details, see the [Platforms & Plugins Version Management](../platform_plugin_versioning_ref/index.html).
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
        name(string) | *Required* <br/> Name of the platform to be restored
        spec(string) | *Required* <br/> Version of the platform to be restored
    -   
    +
        Examples:
     
         <engine name="android" spec="^4.0.0" />
    -    
    +
     ## preference
        Sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms,
        and will be indicated as such.  
     
        Attributes(type) | Description
        ----------------- | ------------
    -   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements. 
    -   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running. 
    +   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements.
    +   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running.
    +   android-maxSdkVersion(integer) | *Default: Not Specified* <br/> ==Android== <br/> Sets the `maxSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    --- End diff --
    
    How about providing a link to the Android docs ? : http://developer.android.com/guide/topics/manifest/uses-sdk-element.html


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by dblotsky <gi...@git.apache.org>.
Github user dblotsky commented on the pull request:

    https://github.com/apache/cordova-docs/pull/490#issuecomment-182044901
  
    LGTM.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by riknoll <gi...@git.apache.org>.
Github user riknoll commented on the pull request:

    https://github.com/apache/cordova-docs/pull/490#issuecomment-181500735
  
    @omefire @dblotsky please review


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by riknoll <gi...@git.apache.org>.
Github user riknoll commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/490#discussion_r52347236
  
    --- Diff: www/docs/en/dev/config_ref/index.md ---
    @@ -131,82 +131,85 @@ platform. See [Icons and Splash Screens](images.html) for more information.
             <content src="startPage.html"></content>
         </widget>
     
    -    
    +
     ## access
    -   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Attributes(type) | Description
        ----------------- | ------------
    -   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with. 
    -   The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with.
    +   The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Examples:
     
         <widget ...>
             <access origin="*"></content>
         </widget>
    -    
    +
         <widget ...>
             <access origin="http://google.com"></content>
         </widget>
    -    
    -    
    +
    +
     ## allow-navigation
        Controls which URLs the WebView itself can be navigated to. Applies to top-level navigations only.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to. 
    +   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#navigation-whitelist) for details.
    -   
    +
        Examples:
    -   
    +
         <!-- Allow links to example.com -->
         <allow-navigation href="http://example.com/*" />
     
         <!-- Wildcards are allowed for the protocol, as a prefix to the host, or as a suffix to the path -->
         <allow-navigation href="*://*.example.com/*" />
    -   
    +
     ## allow-intent
        Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open. 
    +   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#intent-whitelist) for details.  
    -  
    +
        Examples:
    -   
    +
         <allow-intent href="http://*/*" />
         <allow-intent href="https://*/*" />
         <allow-intent href="tel:*" />
         <allow-intent href="sms:*" />
    -  
    +
     ## engine
        Specifies what platform to restore during a prepare. For more details, see the [Platforms & Plugins Version Management](../platform_plugin_versioning_ref/index.html).
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
        name(string) | *Required* <br/> Name of the platform to be restored
        spec(string) | *Required* <br/> Version of the platform to be restored
    -   
    +
        Examples:
     
         <engine name="android" spec="^4.0.0" />
    -    
    +
     ## preference
        Sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms,
        and will be indicated as such.  
     
        Attributes(type) | Description
        ----------------- | ------------
    -   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements. 
    -   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running. 
    +   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements.
    +   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running.
    +   android-maxSdkVersion(integer) | *Default: Not Specified* <br/> ==Android== <br/> Sets the `maxSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    --- End diff --
    
    @omefire I did provide the link. I used the reference style of markdown link (see bottom of document)


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by riknoll <gi...@git.apache.org>.
Github user riknoll commented on the pull request:

    https://github.com/apache/cordova-docs/pull/490#issuecomment-182036432
  
    @dblotsky done


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by riknoll <gi...@git.apache.org>.
Github user riknoll commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/490#discussion_r52349972
  
    --- Diff: www/docs/en/dev/config_ref/index.md ---
    @@ -131,82 +131,85 @@ platform. See [Icons and Splash Screens](images.html) for more information.
             <content src="startPage.html"></content>
         </widget>
     
    -    
    +
     ## access
    -   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Attributes(type) | Description
        ----------------- | ------------
    -   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with. 
    -   The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with.
    +   The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Examples:
     
         <widget ...>
             <access origin="*"></content>
         </widget>
    -    
    +
         <widget ...>
             <access origin="http://google.com"></content>
         </widget>
    -    
    -    
    +
    +
     ## allow-navigation
        Controls which URLs the WebView itself can be navigated to. Applies to top-level navigations only.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to. 
    +   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#navigation-whitelist) for details.
    -   
    +
        Examples:
    -   
    +
         <!-- Allow links to example.com -->
         <allow-navigation href="http://example.com/*" />
     
         <!-- Wildcards are allowed for the protocol, as a prefix to the host, or as a suffix to the path -->
         <allow-navigation href="*://*.example.com/*" />
    -   
    +
     ## allow-intent
        Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open. 
    +   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#intent-whitelist) for details.  
    -  
    +
        Examples:
    -   
    +
         <allow-intent href="http://*/*" />
         <allow-intent href="https://*/*" />
         <allow-intent href="tel:*" />
         <allow-intent href="sms:*" />
    -  
    +
     ## engine
        Specifies what platform to restore during a prepare. For more details, see the [Platforms & Plugins Version Management](../platform_plugin_versioning_ref/index.html).
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
        name(string) | *Required* <br/> Name of the platform to be restored
        spec(string) | *Required* <br/> Version of the platform to be restored
    -   
    +
        Examples:
     
         <engine name="android" spec="^4.0.0" />
    -    
    +
     ## preference
        Sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms,
        and will be indicated as such.  
     
        Attributes(type) | Description
        ----------------- | ------------
    -   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements. 
    -   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running. 
    +   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements.
    +   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running.
    +   android-maxSdkVersion(integer) | *Default: Not Specified* <br/> ==Android== <br/> Sets the `maxSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    +   android-minSdkVersion(integer) | *Default: Dependent on cordova-android Version* <br/> ==Android== <br/> Sets the `minSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    +   android-targetSdkVersion(integer) | *Default: Dependent on cordova-android Version* <br/> ==Android== <br/> Sets the `targetSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    --- End diff --
    
    Sure


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by asfgit <gi...@git.apache.org>.
Github user asfgit closed the pull request at:

    https://github.com/apache/cordova-docs/pull/490


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by omefire <gi...@git.apache.org>.
Github user omefire commented on the pull request:

    https://github.com/apache/cordova-docs/pull/490#issuecomment-182577611
  
    LGTM


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


[GitHub] cordova-docs pull request: CB-10206: Documenting uses-sdk attribut...

Posted by dblotsky <gi...@git.apache.org>.
Github user dblotsky commented on a diff in the pull request:

    https://github.com/apache/cordova-docs/pull/490#discussion_r52255295
  
    --- Diff: www/docs/en/dev/config_ref/index.md ---
    @@ -131,82 +131,85 @@ platform. See [Icons and Splash Screens](images.html) for more information.
             <content src="startPage.html"></content>
         </widget>
     
    -    
    +
     ## access
    -   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   Defines the set of external domains the app is allowed to communicate with. The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Attributes(type) | Description
        ----------------- | ------------
    -   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with. 
    -   The default value shown above allows it to access any server. 
    -   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details. 
    +   origin(string) | *Required* <br/> Defines the set of external domains the app is allowed to communicate with.
    +   The default value shown above allows it to access any server.
    +   See the Domain [Whitelist Guide](../guide/appdev/whitelist/index.html) for details.
     
        Examples:
     
         <widget ...>
             <access origin="*"></content>
         </widget>
    -    
    +
         <widget ...>
             <access origin="http://google.com"></content>
         </widget>
    -    
    -    
    +
    +
     ## allow-navigation
        Controls which URLs the WebView itself can be navigated to. Applies to top-level navigations only.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to. 
    +   href(string) | *Required* <br/> Defines the set of external domains the WebView is allowed to navigate to.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#navigation-whitelist) for details.
    -   
    +
        Examples:
    -   
    +
         <!-- Allow links to example.com -->
         <allow-navigation href="http://example.com/*" />
     
         <!-- Wildcards are allowed for the protocol, as a prefix to the host, or as a suffix to the path -->
         <allow-navigation href="*://*.example.com/*" />
    -   
    +
     ## allow-intent
        Controls which URLs the app is allowed to ask the system to open. By default, no external URLs are allowed.
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
    -   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open. 
    +   href(string) | *Required* <br/> Defines which URLs the app is allowed to ask the system to open.
        See the cordova-plugin-whitelist [cordova-plugin-whitelist](https://github.com/apache/cordova-plugin-whitelist#intent-whitelist) for details.  
    -  
    +
        Examples:
    -   
    +
         <allow-intent href="http://*/*" />
         <allow-intent href="https://*/*" />
         <allow-intent href="tel:*" />
         <allow-intent href="sms:*" />
    -  
    +
     ## engine
        Specifies what platform to restore during a prepare. For more details, see the [Platforms & Plugins Version Management](../platform_plugin_versioning_ref/index.html).
    -   
    +
        Attributes(type) | Description
        ----------------- | ------------
        name(string) | *Required* <br/> Name of the platform to be restored
        spec(string) | *Required* <br/> Version of the platform to be restored
    -   
    +
        Examples:
     
         <engine name="android" spec="^4.0.0" />
    -    
    +
     ## preference
        Sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms,
        and will be indicated as such.  
     
        Attributes(type) | Description
        ----------------- | ------------
    -   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements. 
    -   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running. 
    +   AllowInlineMediaPlayback(boolean) | *Default: false* <br/> ==iOS== <br/> Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any ```<video>``` elements.
    +   AndroidLaunchMode(string) | *Default: singleTop* <br/> Allowed values: standard, singleTop, singleTask, singleInstance <br/> ==Android== <br/> Sets the Activity android:launchMode attribute. This changes what happens when the app is launched from app icon or intent and is already running.
    +   android-maxSdkVersion(integer) | *Default: Not Specified* <br/> ==Android== <br/> Sets the `maxSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    +   android-minSdkVersion(integer) | *Default: Dependent on cordova-android Version* <br/> ==Android== <br/> Sets the `minSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    +   android-targetSdkVersion(integer) | *Default: Dependent on cordova-android Version* <br/> ==Android== <br/> Sets the `targetSdkVersion` attribute of the `<uses-sdk>` tag in the project's `AndroidManifest.xml` (see [uses-sdk][uses-sdk]).
    --- End diff --
    
    Might be more readable to have "see [here]" instead of "see [uses-sdk]."


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org