You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by no...@apache.org on 2020/03/15 17:11:27 UTC

[cordova-docs] branch master updated: usesCleartextTraffic information (#1050)

This is an automated email from the ASF dual-hosted git repository.

normanbreau pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git


The following commit(s) were added to refs/heads/master by this push:
     new f7ac362  usesCleartextTraffic information (#1050)
f7ac362 is described below

commit f7ac362a3259b22799bdb5e092294f2c7cfcd9cd
Author: Mosab A <47...@users.noreply.github.com>
AuthorDate: Sun Mar 15 19:11:18 2020 +0200

    usesCleartextTraffic information (#1050)
    
    * usesCleartextTraffic information
    
    * Update www/docs/en/dev/guide/platforms/android/index.md
    
    Co-Authored-By: Niklas Merz <Ni...@gmx.net>
    
    * Update www/docs/en/dev/guide/platforms/android/index.md
    
    Co-Authored-By: Niklas Merz <Ni...@gmx.net>
    
    * Update www/docs/en/dev/guide/platforms/android/index.md
    
    Co-Authored-By: Niklas Merz <Ni...@gmx.net>
    
    * add more info regarding android element settings
    
    * Add global documentation for android
    
    * Update www/docs/en/dev/guide/platforms/android/index.md
    
    Co-Authored-By: Norman Breau <no...@normanbreau.com>
    
    * Update index.md
    
    * Update index.md
    
    Co-authored-by: Niklas Merz <Ni...@gmx.net>
    Co-authored-by: Norman Breau <no...@normanbreau.com>
---
 www/docs/en/dev/guide/platforms/android/index.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/www/docs/en/dev/guide/platforms/android/index.md b/www/docs/en/dev/guide/platforms/android/index.md
index 073b774..f633f1b 100644
--- a/www/docs/en/dev/guide/platforms/android/index.md
+++ b/www/docs/en/dev/guide/platforms/android/index.md
@@ -766,6 +766,27 @@ The corresponding html:
     </body>
 </html>
 ```
+### Android Quirks
+The default API level in the Cordova Android platform has been upgraded. On an Android 9 device, clear text communication is now disabled by default.
+
+By default HTTP and FTP etc. will refuse the apps requests to use cleartext traffic. The key reason for avoiding cleartext traffic is the lack of confidentiality, authenticity, and protections against tampering; a network attacker can eavesdrop on transmitted data and also modify it without being detected. You can learn more about the `android:usesCleartextTraffic` or any other android application elements setting in the [documentation for Android developers](https://developer.android.co [...]
+
+To allow clear text communication again, set the `android:usesCleartextTraffic` on your application tag to true in `config.xml` file:
+```xml
+<platform name="android">
+  <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
+      <application android:usesCleartextTraffic="true" />
+  </edit-config>
+</platform>
+```
+
+And also you need to add Android XML namespace `xmlns:android="http://schemas.android.com/apk/res/android"` to your widget tag in the same `config.xml`, like so:
+`<widget id="io.cordova.hellocordova" version="0.0.1" android-versionCode="13" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0" xmlns:android="http://schemas.android.com/apk/res/android">
+</widget>`
+
+### Android Manifest Information
+
+You can learn more about the Android manifest information in the [documentation for Android developers](https://developer.android.com/guide/topics/manifest/manifest-intro).
 
 ### Testing the Activity Lifecycle
 


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