Author: janpio
Date: Mon Jun 29 15:21:55 2020
New Revision: 1879336
URL: http://svn.apache.org/viewvc?rev=1879336&view=rev
Log:
Updated docs
Added:
cordova/site/public/announcements/2020/06/29/
cordova/site/public/announcements/2020/06/29/cordova-android-9.0.0.html
Modified:
cordova/site/public/announcements/2020/06/23/cordova-ios-6.1.0.html
cordova/site/public/blog/index.html
cordova/site/public/docs/en/dev/config_ref/index.html
cordova/site/public/docs/en/dev/guide/platforms/android/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
cordova/site/public/feed.xml
cordova/site/public/sitemap.xml
cordova/site/public/static/js/index.js
Modified: cordova/site/public/announcements/2020/06/23/cordova-ios-6.1.0.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/announcements/2020/06/23/cordova-ios-6.1.0.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
--- cordova/site/public/announcements/2020/06/23/cordova-ios-6.1.0.html
(original)
+++ cordova/site/public/announcements/2020/06/23/cordova-ios-6.1.0.html Mon Jun
29 15:21:55 2020
@@ -223,6 +223,26 @@ cordova platform add ios@6.1.0
</div>
<div class="col-sm-6">
+ <a
href="/announcements/2020/06/29/cordova-android-9.0.0.html">Next</a>
+ <br>
+ <br>
+ <a class="title"
href="/announcements/2020/06/29/cordova-android-9.0.0.html">Cordova Android
9.0.0 Released!</a>
+ <div class="date"> 29 Jun 2020 - By Bryan Ellis </div>
+ <p class="content">
+ <!--
+ NOTE:
+ the markdownify filter is used here
+ because posts are rendered in sequence;
+ that is, the next post's content isn't
+ yet rendered at the time that this post
+ is being rendered, so page.next.excerpt
+ is still in Markdown and not HTML
+
+ Reference:
https://github.com/jekyll/jekyll/issues/2860
+ -->
+ We are happy to announce that we have just released
Cordova Android...
+ </p>
+
</div>
</div>
</footer>
Added: cordova/site/public/announcements/2020/06/29/cordova-android-9.0.0.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/announcements/2020/06/29/cordova-android-9.0.0.html?rev=1879336&view=auto
==============================================================================
--- cordova/site/public/announcements/2020/06/29/cordova-android-9.0.0.html
(added)
+++ cordova/site/public/announcements/2020/06/29/cordova-android-9.0.0.html Mon
Jun 29 15:21:55 2020
@@ -0,0 +1,417 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta name="format-detection" content="telephone=no">
+ <meta name="viewport" content="user-scalable=no, initial-scale=1,
maximum-scale=1, minimum-scale=1, width=device-width" />
+ <meta name="description" content="We are happy to announce that we have
just released Cordova Android 9.0.0! This is one of Cordova's supported
platforms for building Android mobile appl...">
+
+ <title>
+
+
+ Cordova Android 9.0.0 Released! - Apache Cordova
+
+
+ </title>
+
+ <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+
+
+
+
+
+
+ <link rel="canonical"
href="https://cordova.apache.org/announcements/2020/06/29/cordova-android-9.0.0.html";>
+
+ <!-- CSS -->
+ <link rel="stylesheet" type="text/css" href="/static/css/main.css">
+ <link rel="stylesheet" type="text/css" href="/static/css/lib/syntax.css">
+ <!-- Algolia Search CSS -->
+ <link rel="stylesheet"
href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"; />
+
+ <!-- Fonts -->
+ <!-- For attribution information, see www/attributions.html -->
+ <link
href='https://fonts.googleapis.com/css?family=Raleway:700,400,300,700italic,400italic,300italic'
rel='stylesheet' type='text/css'>
+
+ <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media
queries -->
+ <!--[if lt IE 9]>
+ <script
src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js";></script>
+ <script
src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js";></script>
+ <![endif]-->
+ <script type="text/javascript">
+ var disqus_developer = 1; // this would set it to developer mode
+ </script>
+
+ <!-- JS -->
+ <script defer type="text/javascript"
src="/static/js/lib/jquery-2.1.1.min.js"></script>
+ <script defer type="text/javascript"
src="/static/js/lib/bootstrap.min.js"></script>
+
+ <script>
+
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new
Date();a=s.createElement(o),
+
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+ ga('create', 'UA-64283057-3', 'auto');
+ ga('send', 'pageview');
+</script>
+
+</head>
+
+<body>
+ <header>
+ <a class="scroll-point pt-top" name="top"></a>
+ <nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed"
data-toggle="collapse" data-target="#navbar" aria-expanded="false"
aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img id="logo_top"
src="/static/img/cordova-logo-newbrand.svg"/></a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <div class="nav_bar_center">
+ <ul class="nav navbar-nav">
+ <li >
+ <a href="/docs/en/latest/">Documentation</a>
+ </li>
+ <li >
+ <a href="/plugins">Plugins</a>
+ </li>
+ <li class="active">
+ <a href="/blog" id="blog_button">Blog<span
class="badge" id="new_blog_count"></span></a>
+ </li>
+ <li >
+ <a href="/contribute">Contribute</a>
+ </li>
+ <li>
+ <a href="/#getstarted">Get Started</a>
+ </li>
+ <li>
+ <form class="navbar-form navbar-right"
id="header-search-form" role="search">
+ <div class="input-group">
+
+
+
+ <input id="header-search-field"
type="text" placeholder="Search '9.x' docs..." class="form-control hidden-xs"
autocomplete="off">
+ </div>
+ </form>
+ </li>
+ </ul>
+ </div>
+ </div><!--/.navbar-collapse -->
+ </div>
+ </nav>
+ <div id="_fixed_navbar_spacer" style="padding-top:50px"></div>
+</header>
+
+<div class="page container">
+ <div class="blog">
+ <h1 class="blogHeader">
+ Blog
+ <span class="rss">
+ <img src="/static/img/subscribe.png"><a href="/feed.xml">RSS Feed</a>
+ </span>
+</h1>
+
+<div class="post">
+ <header>
+ <div class="title">Cordova Android 9.0.0 Released!</div>
+ <div class="author">By:
+
+ Bryan Ellis
+
+ </div>
+ <div class="date">29 Jun 2020</div>
+ </header>
+ <section>
+ <div>
+ <p>We are happy to announce that we have just released
<code>Cordova Android 9.0.0</code>! This is one of Cordova's supported
platforms for building Android mobile applications.</p>
+
+<ul>
+<li><a
href="https://www.npmjs.com/package/cordova-android";>cordova-android@9.0.0</a></li>
+</ul>
+
+<p><strong>To upgrade:</strong></p>
+<div class="highlight"><pre><code class="language-bash"
data-lang="bash">cordova platform remove android
+cordova platform add android@9.0.0
+</code></pre></div>
+<h2>Release Highlights</h2>
+
+<ul>
+<li><p><strong>Added Kotlin Support</strong></p>
+
+<p>Kotlin is one of the newest statically typed languages for developing
Android apps. It is designed to work fully with the existing language, Java.</p>
+
+<p>By default, Cordova has Kotlin disabled but it can be enabled with <a
href="https://cordova.apache.org/docs/en/latest/config_ref/index.html#preference";>the
<code>GradlePluginKotlinEnabled</code> preference</a> in
<code>config.xml</code>.</p>
+
+<p>Additionally, Kotlinâs coding style and version are configurable. By
default, Cordova sets the coding style as <code>official</code> and uses
version <code>1.3.50</code>.</p>
+
+<p>Below is an example <code>config.xml</code> for enabling and configuring
Kotlin.</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinCodeStyle"</span> <span
class="na">value=</span><span class="s">"official"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinVersion"</span> <span
class="na">value=</span><span class="s">"1.3.50"</span> <span
class="nt">/></span>
+</code></pre></div>
+<p>For plugin developers, it is recommended to ensure that the Kotlin files
are placed into the platforms <code>src/main/kotlin</code> directory.</p></li>
+<li><p><strong>Added AndroidX Support</strong></p>
+
+<p>AndroidX is the new and improved namespace for the Android Support
Libraries. The original support libraries are no longer maintained.</p>
+
+<p>It is recommended to use AndroidX so that your app is running the latest
support libraries but, by default, Cordova has AndroidX support disabled for
compatibility with existing plugins.</p>
+
+<p>A lot of the Android supported plugins are still using the old support
libraries which can not build when using the AndroidX support libraries. It is
recommended to research each plugin to see if they support AndroidX before
enabling this feature.</p>
+
+<p>It is recommended for plugin developers to start migrating to support
AndroidX. App developers could also use Jetifier to automatically migrates
their existing third-party libraries to use AndroidX.</p>
+
+<p>You can enable this feature by setting <a
href="https://cordova.apache.org/docs/en/latest/config_ref/index.html#preference";>the
<code>AndroidXEnabled</code> preference</a> to <code>true</code> in
<code>config.xml</code>.</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><preference</span> <span class="na">name=</span><span
class="s">"AndroidXEnabled"</span> <span class="na">value=</span><span
class="s">"true"</span> <span class="nt">/></span>
+</code></pre></div>
+<p>If you were previously using the <a
href="https://www.npmjs.com/package/cordova-plugin-androidx";>cordova-plugin-androidx</a>
plugin to enable AndroidX support, this plugin is no longer needed with this
preference flag.</p>
+
+<p>The <a
href="https://www.npmjs.com/package/cordova-plugin-androidx-adapter";>cordova-plugin-androidx-adapter</a>
plugin can be used to migrate the legacy references to the new AndroidX
references.</p></li>
+<li><p><strong>Added Google Services Support</strong></p>
+
+<p>To use Google APIs or Firebase services, the Gradle plugin <a
href="https://developers.google.com/android/guides/google-services-plugin";>Google
Services</a> is required to be enabled when building your Android
application.</p>
+
+<p>For plugin developers, this can be enabled by setting to the app's
<code>config.xml</code> the <code>GradlePluginGoogleServicesEnabled</code>
<code>preference</code> flag. From the <code>plugin.xml</code> file, you can do
this by adding the following lines:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><config-file</span> <span class="na">target=</span><span
class="s">"config.xml"</span> <span class="na">parent=</span><span
class="s">"/*"</span><span class="nt">></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesVersion"</span> <span
class="na">value=</span><span class="s">"4.2.0"</span> <span
class="nt">/></span>
+<span class="nt"></config-file></span>
+</code></pre></div></li>
+<li><p><strong>Android Version Support Update</strong></p>
+
+<ul>
+<li>The default target SDK version is set to 29.</li>
+<li>The minimum SDK version is set to 22.</li>
+<li>The minimum supported Android version is 5.1.</li>
+</ul>
+
+<p><strong>NOTE:</strong> because Cordova has increased the minimum SDK
version to 22, we <strong>no longer support or test</strong> with Android 5.0
or lower.</p></li>
+<li><p><strong>Gradle and Gradle Plugin Version Support Update</strong></p>
+
+<ul>
+<li>Cordova has increased the default Gradle version to 6.5.</li>
+<li>Cordova has increased the Gradle Plugin to version 4.0.0</li>
+</ul></li>
+</ul>
+
+<p>Please report any issues you find at <a
href="http://issues.cordova.io/";>issues.cordova.io</a>!</p>
+
+<!--more-->
+
+<h2>Full Changelog</h2>
+
+<ul>
+<li><a href="https://github.com/apache/cordova-android/pull/1005";>GH-1005</a>
chore: set AndroidX off by default</li>
+<li><a href="https://github.com/apache/cordova-android/pull/971";>GH-971</a>
fix: Accept multiple mime types on file input</li>
+<li><a href="https://github.com/apache/cordova-android/pull/1001";>GH-1001</a>
fix: support both adaptive and standard icons at the same time</li>
+<li><a href="https://github.com/apache/cordova-android/pull/985";>GH-985</a>
fix: Plugin install fails when preview sdk is installed</li>
+<li><a href="https://github.com/apache/cordova-android/pull/994";>GH-994</a>
chore: cleanup yaml files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/999";>GH-999</a>
chore: remove trailing spaces from Java sources</li>
+<li><a href="https://github.com/apache/cordova-android/pull/992";>GH-992</a>
chore: update some dependencies</li>
+<li><a href="https://github.com/apache/cordova-android/pull/998";>GH-998</a>
chore: remove trailing spaces from framework build files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/997";>GH-997</a>
chore: remove trailing spaces from project template</li>
+<li><a href="https://github.com/apache/cordova-android/pull/996";>GH-996</a>
chore: remove trailing spaces from bat files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/995";>GH-995</a>
remove trailing spaces from markdown files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/993";>GH-993</a>
chore: update <code>devDependencies</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/987";>GH-987</a>
breaking: reduce combined response cutoff to 16 MB</li>
+<li><a href="https://github.com/apache/cordova-android/pull/988";>GH-988</a>
major: Gradle 6.5 & <strong>Android</strong> Gradle plugin 4.0.0
updates</li>
+<li><a href="https://github.com/apache/cordova-android/pull/990";>GH-990</a>
chore: remove trailing spaces from <code>app/build.gradle</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/989";>GH-989</a>
breaking: remove <code>legacy/build.gradle</code> from template</li>
+<li><a href="https://github.com/apache/cordova-android/pull/978";>GH-978</a>
fix: <code>wait_for_boot</code> waiting forever</li>
+<li><a href="https://github.com/apache/cordova-android/pull/965";>GH-965</a>
fix: Increased <code>detectArchitecture()</code> timeout</li>
+<li><a href="https://github.com/apache/cordova-android/pull/962";>GH-962</a>
breaking: Bump <strong>Android</strong> gradle plugin to 3.6.0</li>
+<li><a href="https://github.com/apache/cordova-android/pull/948";>GH-948</a>
feature: JVM Args flag</li>
+<li><a href="https://github.com/apache/cordova-android/pull/951";>GH-951</a>
fix: <code>ANDROID_SDK_ROOT</code> variable</li>
+<li><a href="https://github.com/apache/cordova-android/pull/959";>GH-959</a>
test: synced AndroidX gradle versions to the same version as the
<strong>Android</strong> test</li>
+<li><a href="https://github.com/apache/cordova-android/pull/960";>GH-960</a>
feat: <code>com.android.tools.build:gradle:3.5.3</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/956";>GH-956</a>
chore(npm): add <code>package-lock.json</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/958";>GH-958</a>
chore(npm): add ignore list</li>
+<li><a href="https://github.com/apache/cordova-android/pull/957";>GH-957</a>
chore: various cleanup</li>
+<li><a href="https://github.com/apache/cordova-android/pull/955";>GH-955</a>
chore(eslint): bump package & apply eslint fix</li>
+<li><a href="https://github.com/apache/cordova-android/pull/954";>GH-954</a>
breaking(npm): bump packages</li>
+<li><a href="https://github.com/apache/cordova-android/pull/953";>GH-953</a>
chore(npm): use short notation in <code>package.json</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/823";>GH-823</a>
fix: prevent exit fullscreen mode from closing application</li>
+<li><a href="https://github.com/apache/cordova-android/pull/950";>GH-950</a>
fix: removed redundent logcat print</li>
+<li><a href="https://github.com/apache/cordova-android/pull/915";>GH-915</a>
breaking: bump minSdkVersion to 22 and drop pre-Lollipop specific code</li>
+<li><a href="https://github.com/apache/cordova-android/pull/941";>GH-941</a>
fix: GH-873 App bundle builds to obey command-line arguments</li>
+<li><a href="https://github.com/apache/cordova-android/pull/940";>GH-940</a>
ci: drop travis & move codecov to gh-actions</li>
+<li><a href="https://github.com/apache/cordova-android/pull/929";>GH-929</a>
chore: updated <code>README</code> to reflect what <strong>Android</strong>
requires more accurately, which is Java 8, not anything less, not anything
greater. Java 1.8.x is required.</li>
+<li><a href="https://github.com/apache/cordova-android/pull/937";>GH-937</a>
fix: GH-935 replaced <code>compare-func</code> with native sort method</li>
+<li><a href="https://github.com/apache/cordova-android/pull/939";>GH-939</a>
fix: test failure with shebang interpreter in <code>rewired</code> files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/911";>GH-911</a>
refactor: use es6 class</li>
+<li><a href="https://github.com/apache/cordova-android/pull/910";>GH-910</a>
refactor (eslint): use <code>cordova-eslint</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/909";>GH-909</a>
chore: remove appveyor residual</li>
+<li><a href="https://github.com/apache/cordova-android/pull/895";>GH-895</a>
feat: add github actions</li>
+<li><a href="https://github.com/apache/cordova-android/pull/842";>GH-842</a>
refactor: remove <code>shelljs</code> dependency</li>
+<li><a href="https://github.com/apache/cordova-android/pull/896";>GH-896</a>
feat: add Kotlin support</li>
+<li><a href="https://github.com/apache/cordova-android/pull/901";>GH-901</a>
feat: add AndroidX support</li>
+<li><a href="https://github.com/apache/cordova-android/pull/849";>GH-849</a>
fix: cordova requirements consider the
<code>android-targetSdkVersion</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/904";>GH-904</a>
fix (adb): shell to return expected stdout</li>
+<li><a href="https://github.com/apache/cordova-android/pull/792";>GH-792</a>
feat: upgrade <code>gradle</code> to 6.1 & gradle build tools to 3.5.3</li>
+<li><a href="https://github.com/apache/cordova-android/pull/902";>GH-902</a>
chore: remove <code>.project</code> file & add <code>.settings</code> to
<code>gitignore</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/900";>GH-900</a>
refactor: simplify <code>doFindLatestInstalledBuildTools</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/751";>GH-751</a>
feat: use Java package name for loading <code>BuildConfig</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/898";>GH-898</a>
chore: rename gradle plugin google services <code>preference</code> options</li>
+<li><a href="https://github.com/apache/cordova-android/pull/893";>GH-893</a>
feat: add Google Services support</li>
+<li><a href="https://github.com/apache/cordova-android/pull/709";>GH-709</a>
feat: add <code>version-compare</code> library to compare
<code>build-tools</code> versions properly.</li>
+<li><a href="https://github.com/apache/cordova-android/pull/831";>GH-831</a>
chore: ignore auto-generated eclipse buildship files</li>
+<li><a href="https://github.com/apache/cordova-android/pull/848";>GH-848</a>
breaking: increased default target sdk to 29</li>
+<li><a href="https://github.com/apache/cordova-android/pull/859";>GH-859</a>
breaking: removed unnecessary project name restriction</li>
+<li><a href="https://github.com/apache/cordova-android/pull/833";>GH-833</a>
chore: drop <code>q</code> module</li>
+<li><a href="https://github.com/apache/cordova-android/pull/862";>GH-862</a>
chore: replace <code>superspawn</code> & <code>child_process</code> with
<code>execa</code></li>
+<li><a href="https://github.com/apache/cordova-android/pull/860";>GH-860</a>
feat: don't filter gradle's stderr anymore</li>
+<li><a href="https://github.com/apache/cordova-android/pull/832";>GH-832</a>
chore: drop node 6 and 8 support</li>
+<li><a href="https://github.com/apache/cordova-android/pull/890";>GH-890</a>
chore: bump version to 9.0.0-dev</li>
+<li><a href="https://github.com/apache/cordova-android/pull/697";>GH-697</a>
chore: optimization code</li>
+<li><a href="https://github.com/apache/cordova-android/pull/863";>GH-863</a>
chore: removed comment that serves no purpose</li>
+<li><a href="https://github.com/apache/cordova-android/pull/861";>GH-861</a>
chore: update <code>jasmine</code> to 3.5.0</li>
+<li><a href="https://github.com/apache/cordova-android/pull/858";>GH-858</a>
chore: modernize our one E2E test</li>
+<li><a href="https://github.com/apache/cordova-android/pull/854";>GH-854</a>
chore: ensure to lint as many files as possible</li>
+</ul>
+
+ </div>
+ </section>
+ <footer>
+ <div class="row">
+ <div class="col-sm-6">
+
+ <a
href="/announcements/2020/06/23/cordova-ios-6.1.0.html">Previous</a>
+ <br>
+ <br>
+ <a class="title"
href="/announcements/2020/06/23/cordova-ios-6.1.0.html">Cordova iOS 6.1.0
Released!</a>
+ <div class="date"> 23 Jun 2020 - By Darryl Pogue </div>
+ <p class="content">
+ We are happy to announce that we have just released
Cordova iOS...
+ </p>
+
+ </div>
+ <div class="col-sm-6">
+
+ </div>
+ </div>
+ </footer>
+ <div class="disqus">
+ <div id="disqus_thread"></div>
+<script type="text/javascript">
+ /* * * CONFIGURATION VARIABLES * * */
+ var disqus_shortname = 'cordovablogs';
+
+ /* * * DON'T EDIT BELOW THIS LINE * * */
+ (function() {
+ var dsq = document.createElement('script'); dsq.type =
'text/javascript'; dsq.async = true;
+ dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
+ (document.getElementsByTagName('head')[0] ||
document.getElementsByTagName('body')[0]).appendChild(dsq);
+ })();
+</script>
+<noscript>Please enable JavaScript to view the <a
href="https://disqus.com/?ref_noscript"; rel="nofollow">comments powered by
Disqus.</a></noscript>
+
+ </div>
+</div>
+
+</div>
+
+</div>
+
+<div class="blue-divider"></div>
+<footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-sm-9">
+ <h1>More Resources</h1>
+ <div class="row">
+ <div class="col-sm-4">
+ <h2>General</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank"
href="https://projects.apache.org/project.html?cordova";>Apache Project Page</a>
+ </li>
+ <li>
+ <a
href="http://www.apache.org/dyn/closer.cgi/cordova";>Source Distribution</a>
+ </li>
+ <li>
+ <a target="_blank"
href="http://www.apache.org/licenses/LICENSE-2.0";>License</a>
+ </li>
+ <li>
+ <a href="/artwork">Artwork</a>
+ </li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Development</h2>
+ <ul class="nav">
+ <li><a target="_blank"
href="https://github.com/apache?utf8=%E2%9C%93&q=cordova-";>Source
Code</a></li>
+ <li><a target="_blank"
href="https://issues.apache.org/jira/browse/CB/";>Issue Tracker</a></li>
+ <li><a target="_blank"
href="http://stackoverflow.com/questions/tagged/cordova";>Stack Overflow</a></li>
+ <li><a href="/contact">Mailing List</a></li>
+ <li><a href="/contribute/nightly_builds.html">Nightly
builds</a></li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Apache Software Foundation</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank" href="http://www.apache.org/";>About
ASF</a>
+ </li>
+ <li>
+ <a target="_blank"
href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a>
+ </li>
+ <li>
+ <a target="_blank"
href="http://www.apache.org/foundation/thanks.html";>Thanks</a>
+ </li>
+ <li>
+ <a target="_blank"
href="http://www.apache.org/security/";>Security</a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm-3">
+ <h1>Contribute</h1>
+ <p style="padding-top:20px"><strong>Help Cordova move
forward!</strong></p>
+ <p>Report bugs, improve the docs, or contribute to the code.</p>
+ <a href="/contribute" class="btn btn-lg btn-primary">
+ Learn More
+ </a>
+ <p style="padding-top:20px"> <a
href="https://twitter.com/apachecordova"; class="twitter-follow-button"
data-show-count="false">Follow @apachecordova</a></p>
+ <script async defer
src="https://slack-cordova-io.herokuapp.com/slackin.js";></script>
+ </div>
+</div>
+<p class="copyright_text">
+ Copyright © 2012, 2013, 2015 The Apache Software Foundation, Licensed
under the <a target="_blank"
href="http://www.apache.org/licenses/LICENSE-2.0";>Apache License, Version
2.0</a>.<br/>
+ Apache and the Apache feather logos are <a target="_blank"
href="http://www.apache.org/foundation/marks/list/";>trademarks</a> of The
Apache Software Foundation.
+ <br/>
+ "Raleway" font used under license. For details see the <a
href="/attributions/">attributions page</a>.
+</p>
+
+ </div>
+</footer>
+
+
+ <script defer type="text/javascript" src="/static/js/index.js"></script>
+ <script defer type="text/javascript" src="/static/js/twitter.js"></script>
+
+
+
+
+
+
+
+
+<script type="text/javascript"
src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js";></script>
+<script type="text/javascript">
+ docsearch({
+ apiKey: '0a916ab198bd93d031aa70611271e42e',
+ indexName: 'cordova',
+ inputSelector: '#header-search-field',
+ algoliaOptions: { 'facetFilters': ["version: 9.x", "language: en"] }
+ });
+</script>
+
+</body>
+</html>
Modified: cordova/site/public/blog/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/blog/index.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
--- cordova/site/public/blog/index.html (original)
+++ cordova/site/public/blog/index.html Mon Jun 29 15:21:55 2020
@@ -123,6 +123,100 @@
<li>
<header>
+ <div class="adorner" blogTime="Mon, 29 Jun 2020 00:00:00
+0000"></div>
+ <h2 class="title">
+ <a
href="/announcements/2020/06/29/cordova-android-9.0.0.html">Cordova Android
9.0.0 Released!</a>
+ </h2>
+ <div class="details">
+ <span class="date">29 Jun 2020</span>
+ - by
+ <span class="author">
+
+ Bryan Ellis
+
+ </span>
+ <a class="comment"
href="/announcements/2020/06/29/cordova-android-9.0.0.html#disqus_thread"></a>
+ </div>
+ </header>
+ <section class="post-excerpt">
+ <p><p>We are happy to announce that we have just released
<code>Cordova Android 9.0.0</code>! This is one of Cordova's supported
platforms for building Android mobile applications.</p>
+
+<ul>
+<li><a
href="https://www.npmjs.com/package/cordova-android";>cordova-android@9.0.0</a></li>
+</ul>
+
+<p><strong>To upgrade:</strong></p>
+<div class="highlight"><pre><code class="language-bash"
data-lang="bash">cordova platform remove android
+cordova platform add android@9.0.0
+</code></pre></div>
+<h2>Release Highlights</h2>
+
+<ul>
+<li><p><strong>Added Kotlin Support</strong></p>
+
+<p>Kotlin is one of the newest statically typed languages for developing
Android apps. It is designed to work fully with the existing language, Java.</p>
+
+<p>By default, Cordova has Kotlin disabled but it can be enabled with <a
href="https://cordova.apache.org/docs/en/latest/config_ref/index.html#preference";>the
<code>GradlePluginKotlinEnabled</code> preference</a> in
<code>config.xml</code>.</p>
+
+<p>Additionally, Kotlinâs coding style and version are configurable. By
default, Cordova sets the coding style as <code>official</code> and uses
version <code>1.3.50</code>.</p>
+
+<p>Below is an example <code>config.xml</code> for enabling and configuring
Kotlin.</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinCodeStyle"</span> <span
class="na">value=</span><span class="s">"official"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinVersion"</span> <span
class="na">value=</span><span class="s">"1.3.50"</span> <span
class="nt">/></span>
+</code></pre></div>
+<p>For plugin developers, it is recommended to ensure that the Kotlin files
are placed into the platforms <code>src/main/kotlin</code> directory.</p></li>
+<li><p><strong>Added AndroidX Support</strong></p>
+
+<p>AndroidX is the new and improved namespace for the Android Support
Libraries. The original support libraries are no longer maintained.</p>
+
+<p>It is recommended to use AndroidX so that your app is running the latest
support libraries but, by default, Cordova has AndroidX support disabled for
compatibility with existing plugins.</p>
+
+<p>A lot of the Android supported plugins are still using the old support
libraries which can not build when using the AndroidX support libraries. It is
recommended to research each plugin to see if they support AndroidX before
enabling this feature.</p>
+
+<p>It is recommended for plugin developers to start migrating to support
AndroidX. App developers could also use Jetifier to automatically migrates
their existing third-party libraries to use AndroidX.</p>
+
+<p>You can enable this feature by setting <a
href="https://cordova.apache.org/docs/en/latest/config_ref/index.html#preference";>the
<code>AndroidXEnabled</code> preference</a> to <code>true</code> in
<code>config.xml</code>.</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><preference</span> <span class="na">name=</span><span
class="s">"AndroidXEnabled"</span> <span class="na">value=</span><span
class="s">"true"</span> <span class="nt">/></span>
+</code></pre></div>
+<p>If you were previously using the <a
href="https://www.npmjs.com/package/cordova-plugin-androidx";>cordova-plugin-androidx</a>
plugin to enable AndroidX support, this plugin is no longer needed with this
preference flag.</p>
+
+<p>The <a
href="https://www.npmjs.com/package/cordova-plugin-androidx-adapter";>cordova-plugin-androidx-adapter</a>
plugin can be used to migrate the legacy references to the new AndroidX
references.</p></li>
+<li><p><strong>Added Google Services Support</strong></p>
+
+<p>To use Google APIs or Firebase services, the Gradle plugin <a
href="https://developers.google.com/android/guides/google-services-plugin";>Google
Services</a> is required to be enabled when building your Android
application.</p>
+
+<p>For plugin developers, this can be enabled by setting to the app's
<code>config.xml</code> the <code>GradlePluginGoogleServicesEnabled</code>
<code>preference</code> flag. From the <code>plugin.xml</code> file, you can do
this by adding the following lines:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span
class="nt"><config-file</span> <span class="na">target=</span><span
class="s">"config.xml"</span> <span class="na">parent=</span><span
class="s">"/*"</span><span class="nt">></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+ <span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesVersion"</span> <span
class="na">value=</span><span class="s">"4.2.0"</span> <span
class="nt">/></span>
+<span class="nt"></config-file></span>
+</code></pre></div></li>
+<li><p><strong>Android Version Support Update</strong></p>
+
+<ul>
+<li>The default target SDK version is set to 29.</li>
+<li>The minimum SDK version is set to 22.</li>
+<li>The minimum supported Android version is 5.1.</li>
+</ul>
+
+<p><strong>NOTE:</strong> because Cordova has increased the minimum SDK
version to 22, we <strong>no longer support or test</strong> with Android 5.0
or lower.</p></li>
+<li><p><strong>Gradle and Gradle Plugin Version Support Update</strong></p>
+
+<ul>
+<li>Cordova has increased the default Gradle version to 6.5.</li>
+<li>Cordova has increased the Gradle Plugin to version 4.0.0</li>
+</ul></li>
+</ul>
+
+<p>Please report any issues you find at <a
href="http://issues.cordova.io/";>issues.cordova.io</a>!</p>
+</p>
+ <div><a
href="/announcements/2020/06/29/cordova-android-9.0.0.html">More...</a></div>
+ </section>
+ </li>
+
+ <li>
+ <header>
<div class="adorner" blogTime="Tue, 23 Jun 2020 00:00:00
+0000"></div>
<h2 class="title">
<a
href="/announcements/2020/06/23/cordova-ios-6.1.0.html">Cordova iOS 6.1.0
Released!</a>
@@ -9624,7 +9718,7 @@ window.twttr = (function(d, s, id) {
<script>
window.onload = function(){
setTimeout(function(){
- var lastPostTime = new Date("Tue, 23 Jun 2020 00:00:00
+0000").getTime();
+ var lastPostTime = new Date("Mon, 29 Jun 2020 00:00:00
+0000").getTime();
setCookie("visitTime", lastPostTime, 365);
}, 2000);
};
Modified: cordova/site/public/docs/en/dev/config_ref/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/config_ref/index.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/config_ref/index.html (original)
+++ cordova/site/public/docs/en/dev/config_ref/index.html Mon Jun 29 15:21:55
2020
@@ -2906,6 +2906,10 @@ and will be indicated as such.</p>
<td><em>Default: singleTop</em> <br/> Allowed values: standard, singleTop,
singleTask, singleInstance <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.</td>
</tr>
<tr>
+<td>AndroidXEnabled(string) <br/> <mark>Android</mark></td>
+<td><em>Default: false</em> <br/> Sets to true to use AndroidX Support
Libraries.</td>
+</tr>
+<tr>
<td>android-maxSdkVersion(integer) <br/> <mark>Android</mark></td>
<td><em>Default: Not Specified</em> <br/> Sets the <code>maxSdkVersion</code>
attribute of the <code><uses-sdk></code> tag in the project's
<code>AndroidManifest.xml</code> (see <a
href="http://developer.android.com/guide/topics/manifest/uses-sdk-element.html";>here</a>).</td>
</tr>
@@ -2978,6 +2982,26 @@ and will be indicated as such.</p>
<td><em>Default: -1</em> <br/> <strong>(OS X 4.0.0+)</strong> Sets the timeout
for hiding the mouse pointer. Set to 0 for immediate, set to -1 for never.</td>
</tr>
<tr>
+<td>GradlePluginGoogleServicesEnabled (boolean) <br/> <mark>Android</mark></td>
+<td><em>Default: false</em> <br/> Set to true to enable the Google Services
Gradle plugin.</td>
+</tr>
+<tr>
+<td>GradlePluginGoogleServicesEnabled (semver) <br/> <mark>Android</mark></td>
+<td><em>Default: 4.2.0</em> <br/> Set version of Google Services Gradle
plugin to be used.</td>
+</tr>
+<tr>
+<td>GradlePluginKotlinEnabled (boolean) <br/> <mark>Android</mark></td>
+<td><em>Default: false</em> <br/> Set to true to allow Kotlin files to be
built.</td>
+</tr>
+<tr>
+<td>GradlePluginKotlinCodeStyle (string) <br/> <mark>Android</mark></td>
+<td><em>Default: official</em> <br/> Allowed values: official, obsolete<br/>
Sets how the Kotlin code is formatting for readability.</td>
+</tr>
+<tr>
+<td>GradlePluginKotlinVersion (semver) <br/> <mark>Android</mark></td>
+<td><em>Default: 1.3.50</em> <br/> Set the version of the Kotlin Gradle plugin
to be used.</td>
+</tr>
+<tr>
<td>InAppBrowserStorageEnabled (boolean) <br/> <mark>Android</mark></td>
<td><em>Default: true</em> <br/> Controls whether pages opened within an
InAppBrowser can access the same localStorage and WebSQL storage as pages
opened with the default browser.</td>
</tr>
@@ -3165,6 +3189,12 @@ and will be indicated as such.</p>
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"DefaultVolumeStream"</span> <span class="na">value=</span><span
class="s">"call"</span> <span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"OverrideUserAgent"</span> <span class="na">value=</span><span
class="s">"Mozilla/5.0 My Browser"</span> <span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"AppendUserAgent"</span> <span class="na">value=</span><span
class="s">"My Browser"</span> <span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"AndroidXEnabled"</span> <span class="na">value=</span><span
class="s">"true"</span> <span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginGoogleServicesVersion"</span> <span
class="na">value=</span><span class="s">"4.2.0"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinEnabled"</span> <span
class="na">value=</span><span class="s">"true"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinCodeStyle"</span> <span
class="na">value=</span><span class="s">"official"</span> <span
class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"GradlePluginKotlinVersion"</span> <span
class="na">value=</span><span class="s">"1.3.50"</span> <span
class="nt">/></span>
<span class="c"><!-- Windows only preferences --></span>
<span class="nt"><preference</span> <span class="na">name=</span><span
class="s">"windows-target-version"</span> <span class="na">value=</span><span
class="s">"8.1"</span> <span class="nt">/></span>
Modified: cordova/site/public/docs/en/dev/guide/platforms/android/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/guide/platforms/android/index.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/android/index.html
(original)
+++ cordova/site/public/docs/en/dev/guide/platforms/android/index.html Mon Jun
29 15:21:55 2020
@@ -2543,7 +2543,7 @@ the CLI, see <a href="../../../reference
<p>Cordova for Android requires the Android SDK which can be installed
on OS X, Linux or Windows. See the Android SDK's
<a href="http://developer.android.com/sdk/index.html#Requirements";>System
Requirements</a>.
-Cordova's latest Android package supports up to Android <a
href="http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels";>API
Level</a> 28.
+Cordova's latest Android package supports up to Android <a
href="http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels";>API
Level</a> 29.
The supported Android API Levels and Android Versions for the past
few cordova-android releases can be found in this table:</p>
@@ -2555,6 +2555,11 @@ few cordova-android releases can be foun
</tr>
</thead><tbody>
<tr>
+<td>9.X.X</td>
+<td>22 - 29</td>
+<td>5.1 - 10.0.0</td>
+</tr>
+<tr>
<td>8.X.X</td>
<td>19 - 28</td>
<td>4.4 - 9.0.0</td>
Modified:
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
---
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
(original)
+++
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
Mon Jun 29 15:21:55 2020
@@ -2583,29 +2583,42 @@
<p>This plugin displays and hides a splash screen while your web application
is launching. Using its methods you can also show and hide the splash screen
manually.</p>
<ul>
+<li><a href="#cordova-plugin-splashscreen">cordova-plugin-splashscreen</a>
+
+<ul>
<li><a href="#installation">Installation</a></li>
<li><a href="#supported-platforms">Supported Platforms</a></li>
-<li><a href="#platform-splash-screen-image-configuration">Platform Splash
Screen Image Configuration</a>
+<li><a href="#platform-splash-screen-image-configuration">Platform Splash
Screen Image Configuration</a></li>
+<li><a href="#example-configuration">Example Configuration</a></li>
+<li><a href="#ios-specific-information">iOS-specific Information</a>
<ul>
-<li><a href="#example-configuration">Example Configuration</a></li>
-<li><a href="#ios-specific-information">iOS-specific Information</a></li>
-<li><a href="#windows-specific-information">Windows-specific
Information</a></li>
+<li><a href="#launch-storyboard-images">Launch Storyboard Images</a></li>
+<li><a href="#designing-launch-storyboard-images">Designing Launch Storyboard
Images</a></li>
+<li><a href="#scale">Scale</a></li>
+<li><a href="#idioms">Idioms</a></li>
+<li><a href="#size-classes">Size classes</a></li>
+<li><a href="#single-image-launch-screen">Single-image launch screen</a></li>
+<li><a href="#multi-image-launch-screen">Multi-image launch screen</a></li>
+<li><a href="#quirks-and-known-issues">Quirks and Known Issues</a></li>
</ul></li>
-<li><a href="#preferences">Preferences</a>
+<li><a href="#windows-specific-information">Windows-specific
Information</a></li>
+<li><a href="#preferences">Preferences</a></li>
+<li><a href="#configxml">config.xml</a></li>
+<li><a href="#quirks">Quirks</a>
<ul>
-<li><a href="#configxml">config.xml</a></li>
-<li><a href="#quirks">Quirks</a></li>
<li><a href="#android-quirks">Android Quirks</a></li>
<li><a href="#browser-quirks">Browser Quirks</a></li>
<li><a href="#ios-quirks">iOS Quirks</a></li>
<li><a href="#windows-quirks">Windows Quirks</a></li>
</ul></li>
-<li><a href="#methods">Methods</a>
+<li><a href="#methods">Methods</a></li>
+<li><a href="#splashscreenhide">splashscreen.hide</a>
<ul>
-<li><a href="#splashscreenhide">splashscreen.hide</a></li>
+<li><a href="#ios-quirk">iOS Quirk</a></li>
+</ul></li>
<li><a href="#splashscreenshow">splashscreen.show</a></li>
</ul></li>
</ul>
@@ -2667,22 +2680,7 @@ cordova plugin add https://github.com/ap
<span class="nt"></platform></span>
<span class="nt"><platform</span> <span class="na">name=</span><span
class="s">"ios"</span><span class="nt">></span>
- <span class="c"><!-- There are two mechanisms for showing launch images.
- -- Legacy method (supports all devices except iPad Pro 12.9):
- -- Note: Images are determined by width and height. The following are
supported --></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default~iphone.png"</span> <span
class="na">width=</span><span class="s">"320"</span> <span
class="na">height=</span><span class="s">"480"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~iphone.png"</span> <span
class="na">width=</span><span class="s">"640"</span> <span
class="na">height=</span><span class="s">"960"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Portrait~ipad.png"</span> <span
class="na">width=</span><span class="s">"768"</span> <span
class="na">height=</span><span class="s">"1024"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Portrait@2x~ipad.png"</span> <span
class="na">width=</span><span class="s">"1536"</span> <span
class="na">height=</span><span class="s">"2048"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Landscape~ipad.png"</span> <span
class="na">width=</span><span class="s">"1024"</span> <span
class="na">height=</span><span class="s">"768"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Landscape@2x~ipad.png"</span> <span
class="na">width=</span><span class="s">"2048"</span> <span
class="na">height=</span><span class="s">"1536"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-568h@2x~iphone.png"</span> <span
class="na">width=</span><span class="s">"640"</span> <span
class="na">height=</span><span class="s">"1136"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-667h.png"</span> <span
class="na">width=</span><span class="s">"750"</span> <span
class="na">height=</span><span class="s">"1334"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-736h.png"</span> <span
class="na">width=</span><span class="s">"1242"</span> <span
class="na">height=</span><span class="s">"2208"</span><span
class="nt">/></span>
- <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default-Landscape-736h.png"</span> <span
class="na">width=</span><span class="s">"2208"</span> <span
class="na">height=</span><span class="s">"1242"</span><span
class="nt">/></span>
- <span class="c"><!-- Storyboard method (supports all devices):
- -- Important: If you use the storyboard method, legacy images are
- -- copied but ignored.
+ <span class="c"><!-- Storyboard (supports all devices):
-- Note: images are determined by scale, idiom, and size traits. The
following
-- are suggested based on current device form factors --></span>
<span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~universal~anyany.png"</span> <span
class="nt">/></span>
@@ -2710,107 +2708,24 @@ cordova plugin add https://github.com/ap
</code></pre></div>
<h3>iOS-specific Information</h3>
-<p>There are two mechanisms for displaying a launch screen on iOS:</p>
+<p>Launch storyboard images are sized based on scale, idiom, and size classes.
It supports all devices, and can be used with split-screen/slide-over
multitasking.</p>
-<ol>
-<li><p>Legacy launch images: images are sized exactly for the device's
screen size. Does not support the iPad Pro 12.9's native resolution or
split-screen/slide-over multitasking.</p></li>
-<li><p>Launch storyboard images: Images are sized based on scale, idiom, and
size classes. Supports all devices, and can be used with
split-screen/slide-over multitasking.</p></li>
-</ol>
-
-<p>Apple is moving away from legacy launch images. There is no official
support for providing a native-resolution launch image for the iPad Pro 12.9 or
for providing launch images that work with split-screen multitasking or
slide-over. If your app doesn't need to support these contexts, then you
can continue to use legacy launch images for as long as you like. </p>
-
-<p>The preferred method of providing launch images is to use a launch
storyboard. For native app developers, the ideal launch storyboard is an
unpopulated version of the app's user interface at launch. For non-native
app developers who don't wish to learn Interface Builder, however, this
plugin simulates the legacy launch image method as much as is feasible.</p>
-
-<p><strong>Note:</strong> Since iOS 11, for iPhone X devices and greater (with
notch screen), you should switch to the new storyboard splash screens, taking
into account to add <code>viewport-fit=cover</code> to the viewport meta tag in
your <code>index.html</code> file to display the app correctly like so:
<code><meta name="viewport" content="user-scalable=no,
initial-scale=1, width=device-width, viewport-fit=cover"></code> and
make some modification to your app style by adding: <code>padding:
env(safe-area-inset-top)</code> to your <code>index.css</code> file to avoid
the unsafe areas behind notches in the screen.</p>
-
-<h4>Legacy launch images</h4>
-
-<p>If you choose to use legacy launch images, you will use the following
syntax in <code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">
<splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
- <splash src="res/screen/ios/Default@2x~iphone.png" width="640"
height="960"/>
- <splash src="res/screen/ios/Default-Portrait~ipad.png" width="768"
height="1024"/>
- <splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536"
height="2048"/>
- <splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024"
height="768"/>
- <splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048"
height="1536"/>
- <splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640"
height="1136"/>
- <splash src="res/screen/ios/Default-667h.png" width="750"
height="1334"/>
- <splash src="res/screen/ios/Default-736h.png" width="1242"
height="2208"/>
-</code></pre></div>
-<p>Technically the filename for the <code>src</code> attribute can be anything
you want; the filenames are used because they match what will be used when your
project is compiled. The width and height attributes determine which launch
images are displayed on which devices as follows:</p>
-
-<table><thead>
-<tr>
-<th style="text-align: center">width</th>
-<th style="text-align: center">height</th>
-<th style="text-align: center">device (orientation)</th>
-</tr>
-</thead><tbody>
-<tr>
-<td style="text-align: center">320</td>
-<td style="text-align: center">480</td>
-<td style="text-align: center">All non-retina iPhones and iPods</td>
-</tr>
-<tr>
-<td style="text-align: center">640</td>
-<td style="text-align: center">960</td>
-<td style="text-align: center">iPhone 4/4s (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">640</td>
-<td style="text-align: center">1136</td>
-<td style="text-align: center">iPhone 5/5s/SE (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">750</td>
-<td style="text-align: center">1334</td>
-<td style="text-align: center">iPhone 6/6s/7 (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">1242</td>
-<td style="text-align: center">2208</td>
-<td style="text-align: center">iPhone 6+/6s+/7+ (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">2208</td>
-<td style="text-align: center">1242</td>
-<td style="text-align: center">iPhone 6+/6s+/7+ (landscape)</td>
-</tr>
-<tr>
-<td style="text-align: center">768</td>
-<td style="text-align: center">1024</td>
-<td style="text-align: center">All non-retina iPads (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">1024</td>
-<td style="text-align: center">768</td>
-<td style="text-align: center">All non-retina iPads (landscape)</td>
-</tr>
-<tr>
-<td style="text-align: center">1536</td>
-<td style="text-align: center">2048</td>
-<td style="text-align: center">All retina iPads (portrait)</td>
-</tr>
-<tr>
-<td style="text-align: center">2048</td>
-<td style="text-align: center">1536</td>
-<td style="text-align: center">All retina iPads (landscape)</td>
-</tr>
-</tbody></table>
+<p>There is no official support for providing a native-resolution launch image
for the iPad Pro 12.9 or for providing launch images that work with
split-screen multitasking or slide-over.</p>
-<p>Note: It is vitally important that the source image actually matches the
size specified in the <code>width</code> and <code>height</code> attributes. If
it does not, the device may fail to render it properly, if at all.</p>
+<p><strong>Note:</strong> Since iOS 11, for iPhone X devices and greater (with
notch screen), make sure to add <code>viewport-fit=cover</code> to the viewport
meta tag in your <code>index.html</code> file to display the app correctly like
so: <code><meta name="viewport" content="user-scalable=no,
initial-scale=1, width=device-width, viewport-fit=cover"></code> and
make some modification to your app style by adding: <code>padding:
env(safe-area-inset-top)</code> to your <code>index.css</code> file to avoid
the unsafe areas behind notches in the screen.</p>
-<h4>Launch storyboard images</h4>
+<h4>Launch Storyboard Images</h4>
-<p>In order to support newer form factors and split-screen/slide-over
multitasking, you should use launch storyboard images. These are similar to the
legacy launch images above, but there are crucial differences:</p>
+<p>To support newer form factors and split-screen/slide-over multitasking,
launch storyboard images are used.</p>
<ul>
-<li><p>images are not specific to a given device.</p></li>
-<li><p>images are scaled to fill the available viewport (while maintaining the
aspect ratio).</p></li>
-<li><p>the outer edges of the images will be cropped, and the amount will vary
based on device an viewport.</p></li>
-<li><p>there is no need to provide an image for each possible device,
viewport, and orientation; iOS will choose the best image for the situation
automatically.</p></li>
+<li>images are not specific to a given device.</li>
+<li>images are scaled to fill the available viewport (while maintaining the
aspect ratio).</li>
+<li>the outer edges of the images will be cropped, and the amount will vary
based on device an viewport.</li>
+<li>there is no need to provide an image for each possible device, viewport,
and orientation; iOS will choose the best image for the situation
automatically.</li>
</ul>
-<h5>Designing launch storyboard images</h5>
+<h5>Designing Launch Storyboard Images</h5>
<p>The key to designing a launch storyboard image is understanding that the
edges of the image will almost certainly be cropped. Therefore, one should not
place any important information near the edges of any images provided to the
launch storyboard. Only the center is a safe area, and this all but guarantees
that following Apple's advice of presenting an unpopulated user interface
will not work well.</p>
@@ -2820,18 +2735,14 @@ cordova plugin add https://github.com/ap
<li><p>Important graphics (logos, icons, titles) should be centered. The safe
bounding region will vary, so you will need to test to ensure that the
important graphics are never cropped. Better yet, don't supply any
important graphics in the first place.</p>
<ul>
-<li>You <em>can</em> fine-tune the placement and size of these graphics, but
you don't have the same fine-grained control as you did with legacy launch
images.</li>
+<li>You <em>can</em> fine-tune the placement and size of these graphics.</li>
</ul></li>
-<li><p>Use a simple color wash. If you use two colors, you'll want one
color to fill the top half of the image, and the second to fill the bottom
half. If you use a gradient, you'll probably want to ensure that the
middle of the gradient lines up with the center of the image. </p></li>
+<li><p>Use a simple color wash. If you use two colors, you'll want one
color to fill the top half of the image, and the second to fill the bottom
half. If you use a gradient, you'll probably want to ensure that the
middle of the gradient lines up with the center of the image.</p></li>
<li><p>Don't worry about pixel perfection -- because the images are
scaled, there's almost no chance the images will be perfectly fit to the
pixel grid. Since all supported iOS devices use retina screens, users will be
hard pressed to notice it anyway.</p></li>
</ul>
<p>It is important to understand the concept of scale, idiom, and size class
traits in order to use launch storyboard images effectively. Of the images
supplied to the launch storyboard, iOS will choose the image that best matches
the device and viewport and render that image. It is possible to supply only
one launch image if so desired, but it is also possible to fine-tune the
displayed launch image based on traits. When fine-tuning, one can ignore traits
that aren't targeted or supported by the app.</p>
-<blockquote>
-<p>Note: If you are using launch storyboard images, there is no need to
include legacy images. If you do, the legacy images will be copied, but not
used.</p>
-</blockquote>
-
<h5>Scale</h5>
<table><thead>
@@ -2924,15 +2835,15 @@ cordova plugin add https://github.com/ap
<p>If your launch image is simple, you may be able to avoid creating a lot of
different launch images and supply only one. The launch image needs to meet the
following requirements:</p>
<ul>
-<li><p>the image should be square</p></li>
-<li><p>the image should be large enough to fit on an iPad Pro 12.9":
2732x2732</p></li>
-<li><p>anything important should fit within the center</p></li>
+<li>the image should be square</li>
+<li>the image should be large enough to fit on an iPad Pro 12.9":
2732x2732</li>
+<li>anything important should fit within the center</li>
</ul>
-<p>Keep in mind that the image will be cropped, possibly quite severely,
depending upon the viewport. </p>
+<p>Keep in mind that the image will be cropped, possibly quite severely,
depending upon the viewport.</p>
<p>Once the image is created, you can include it in your project by adding the
following to <code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">
<splash src="res/screen/ios/Default@2x~universal~anyany.png" />
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~universal~anyany.png"</span> <span
class="nt">/></span>
</code></pre></div>
<p>Because only one image is provided, iOS will utilize it in every
context.</p>
@@ -3009,12 +2920,12 @@ cordova plugin add https://github.com/ap
</blockquote>
<p>The above looks like the following snippet when present in
<code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">
<splash src="res/screen/ios/Default@2x~universal~anyany.png" />
- <splash src="res/screen/ios/Default@2x~universal~comany.png" />
- <splash src="res/screen/ios/Default@2x~universal~comcom.png" />
- <splash src="res/screen/ios/Default@3x~universal~anyany.png" />
- <splash src="res/screen/ios/Default@3x~universal~anycom.png" />
- <splash src="res/screen/ios/Default@3x~universal~comany.png" />
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~universal~anyany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~universal~comany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~universal~comcom.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~universal~anyany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~universal~anycom.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~universal~comany.png"</span> <span
class="nt">/></span>
</code></pre></div>
<p>Should one need to further fine tune based upon device idiom, one can do
so. This might look like so:</p>
@@ -3097,14 +3008,14 @@ cordova plugin add https://github.com/ap
<p>* this image is required in order for iOS utilize the other images within
this scale and idiom.</p>
<p>The above looks like the following in <code>config.xml</code>:</p>
-<div class="highlight"><pre><code class="language-" data-lang="">
<splash src="res/screen/ios/Default@2x~iphone~anyany.png" />
- <splash src="res/screen/ios/Default@2x~iphone~comany.png" />
- <splash src="res/screen/ios/Default@2x~iphone~comcom.png" />
- <splash src="res/screen/ios/Default@3x~iphone~anyany.png" />
- <splash src="res/screen/ios/Default@3x~iphone~anycom.png" />
- <splash src="res/screen/ios/Default@3x~iphone~comany.png" />
- <splash src="res/screen/ios/Default@2x~ipad~anyany.png" />
- <splash src="res/screen/ios/Default@2x~ipad~comany.png" />
+<div class="highlight"><pre><code class="language-xml" data-lang="xml">
<span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~iphone~anyany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~iphone~comany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~iphone~comcom.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~iphone~anyany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~iphone~anycom.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@3x~iphone~comany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~ipad~anyany.png"</span> <span
class="nt">/></span>
+ <span class="nt"><splash</span> <span class="na">src=</span><span
class="s">"res/screen/ios/Default@2x~ipad~comany.png"</span> <span
class="nt">/></span>
</code></pre></div>
<h5>Quirks and Known Issues</h5>
Modified:
cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
URL:
http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html?rev=1879336&r1=1879335&r2=1879336&view=diff
==============================================================================
---
cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
(original)
+++
cordova/site/public/docs/en/dev/reference/cordova-plugin-statusbar/index.html
Mon Jun 29 15:21:55 2020
@@ -2690,7 +2690,7 @@ function onDeviceReady() {
<h2>Supported Platforms</h2>
<ul>
-<li>iOS 7+</li>
+<li>iOS</li>
<li>Android 5+</li>
</ul>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
