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