This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/asf-site by this push:
new beba8be851 Deploying to asf-site from @
apache/cordova-docs@e19263747fc1f735fa174050dddde5919c176dac 🚀
beba8be851 is described below
commit beba8be851856fd7b3706e3cb10330c9d21ed296
Author: erisu <er...@users.noreply.github.com>
AuthorDate: Mon Mar 24 14:33:24 2025 +0000
Deploying to asf-site from @
apache/cordova-docs@e19263747fc1f735fa174050dddde5919c176dac 🚀
---
docs/en/11.x/guide/platforms/android/plugin.html | 30 ++++++++++++++++------
.../guide/platforms/android/plugin.html | 30 ++++++++++++++++------
docs/en/12.x/guide/platforms/android/plugin.html | 30 ++++++++++++++++------
docs/en/dev/guide/platforms/android/plugin.html | 30 ++++++++++++++++------
feed.xml | 4 +--
5 files changed, 90 insertions(+), 34 deletions(-)
diff --git a/docs/en/11.x/guide/platforms/android/plugin.html
b/docs/en/11.x/guide/platforms/android/plugin.html
index 060664ff03..5c45671887 100644
--- a/docs/en/11.x/guide/platforms/android/plugin.html
+++ b/docs/en/11.x/guide/platforms/android/plugin.html
@@ -2621,20 +2621,34 @@ documentation <a
href="http://developer.android.com/guide/topics/security/permis
<span class="o">}</span>
</code></pre></div></div>
-<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, which
-every plugin should override. An example of this can be found below:</p>
+<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, a forwarded <a
href="https://developer.android.com/reference/android/app/Activity#onRequestPermissionsResult(int,%20java.lang.String[],%20int[])">Android
method</a>, which every plugin should override. An example of this can be
found below:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kt">void</span> <span class="nf">onRequestPermissionResult</span><span
class="o">(</span><span class="kt">int</span> <span
class="n">requestCode</span><span class="o">,</span> <span
class="nc">String</span><span class="o">[]</span> <span
class="n">permissions</span><span class="o">,</span>
- <span class="kt">int</span><span
class="o">[]</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="kd">throws</span> <span class="nc">JSONException</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Override</span>
+<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">onRequestPermissionResult</span><span class="o">(</span><span
class="kt">int</span> <span class="n">requestCode</span><span
class="o">,</span> <span class="nc">String</span><span class="o">[]</span>
<span class="n">permissions</span><span class="o">,</span> <span
class="kt">int</span><span class="o">[]</span> <span
class="n">grantResults</span><span class="o">)</span> <span
class="kd">throws</span> <span class=" [...]
<span class="o">{</span>
- <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="nl">r:</span><span
class="n">grantResults</span><span class="o">)</span>
+ <span class="c1">// It is possible that the permissions request
interaction with the user is interrupted.</span>
+ <span class="c1">// In this case you will receive an empty permissions and
grantResults array, which should be</span>
+ <span class="c1">// treated as a cancellation.</span>
+ <span class="kt">boolean</span> <span class="n">granted</span> <span
class="o">=</span> <span class="n">grantResults</span><span
class="o">.</span><span class="na">length</span> <span class="o">!=</span>
<span class="mi">0</span><span class="o">;</span>
+
+ <span class="c1">// Check if a permission is denied by user</span>
+ <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="n">grantResult</span> <span
class="o">:</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">if</span><span class="o">(</span><span
class="n">r</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
+ <span class="k">if</span><span class="o">(</span><span
class="n">grantResult</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span> [...]
- <span class="k">return</span><span class="o">;</span>
+ <span class="n">granted</span> <span class="o">=</span> <span
class="kc">false</span><span class="o">;</span>
+ <span class="k">break</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
+
+ <span class="c1">// User denied a permission</span>
+ <span class="k">if</span><span class="o">(!</span><span
class="n">granted</span><span class="o">)</span>
+ <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span><spa [...]
+ <span class="k">return</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c1">// Handle the request with the granted permission</span>
<span class="k">switch</span><span class="o">(</span><span
class="n">requestCode</span><span class="o">)</span>
<span class="o">{</span>
<span class="k">case</span> <span class="nl">SEARCH_REQ_CODE:</span>
diff --git a/docs/en/12.x-2025.01/guide/platforms/android/plugin.html
b/docs/en/12.x-2025.01/guide/platforms/android/plugin.html
index f6419e744f..3c5dce9b26 100644
--- a/docs/en/12.x-2025.01/guide/platforms/android/plugin.html
+++ b/docs/en/12.x-2025.01/guide/platforms/android/plugin.html
@@ -2668,20 +2668,34 @@ documentation <a
href="https://developer.android.com/guide/topics/security/permi
<span class="o">}</span>
</code></pre></div></div>
-<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, which
-every plugin should override. An example of this can be found below:</p>
+<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, a forwarded <a
href="https://developer.android.com/reference/android/app/Activity#onRequestPermissionsResult(int,%20java.lang.String[],%20int[])">Android
method</a>, which every plugin should override. An example of this can be
found below:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kt">void</span> <span class="nf">onRequestPermissionResult</span><span
class="o">(</span><span class="kt">int</span> <span
class="n">requestCode</span><span class="o">,</span> <span
class="nc">String</span><span class="o">[]</span> <span
class="n">permissions</span><span class="o">,</span>
- <span class="kt">int</span><span
class="o">[]</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="kd">throws</span> <span class="nc">JSONException</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Override</span>
+<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">onRequestPermissionResult</span><span class="o">(</span><span
class="kt">int</span> <span class="n">requestCode</span><span
class="o">,</span> <span class="nc">String</span><span class="o">[]</span>
<span class="n">permissions</span><span class="o">,</span> <span
class="kt">int</span><span class="o">[]</span> <span
class="n">grantResults</span><span class="o">)</span> <span
class="kd">throws</span> <span class=" [...]
<span class="o">{</span>
- <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="nl">r:</span><span
class="n">grantResults</span><span class="o">)</span>
+ <span class="c1">// It is possible that the permissions request
interaction with the user is interrupted.</span>
+ <span class="c1">// In this case you will receive an empty permissions and
grantResults array, which should be</span>
+ <span class="c1">// treated as a cancellation.</span>
+ <span class="kt">boolean</span> <span class="n">granted</span> <span
class="o">=</span> <span class="n">grantResults</span><span
class="o">.</span><span class="na">length</span> <span class="o">!=</span>
<span class="mi">0</span><span class="o">;</span>
+
+ <span class="c1">// Check if a permission is denied by user</span>
+ <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="n">grantResult</span> <span
class="o">:</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">if</span><span class="o">(</span><span
class="n">r</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
+ <span class="k">if</span><span class="o">(</span><span
class="n">grantResult</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span> [...]
- <span class="k">return</span><span class="o">;</span>
+ <span class="n">granted</span> <span class="o">=</span> <span
class="kc">false</span><span class="o">;</span>
+ <span class="k">break</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
+
+ <span class="c1">// User denied a permission</span>
+ <span class="k">if</span><span class="o">(!</span><span
class="n">granted</span><span class="o">)</span>
+ <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span><spa [...]
+ <span class="k">return</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c1">// Handle the request with the granted permission</span>
<span class="k">switch</span><span class="o">(</span><span
class="n">requestCode</span><span class="o">)</span>
<span class="o">{</span>
<span class="k">case</span> <span class="nl">SEARCH_REQ_CODE:</span>
diff --git a/docs/en/12.x/guide/platforms/android/plugin.html
b/docs/en/12.x/guide/platforms/android/plugin.html
index 3cffae9aa6..b63808a319 100644
--- a/docs/en/12.x/guide/platforms/android/plugin.html
+++ b/docs/en/12.x/guide/platforms/android/plugin.html
@@ -2652,20 +2652,34 @@ documentation <a
href="https://developer.android.com/guide/topics/security/permi
<span class="o">}</span>
</code></pre></div></div>
-<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, which
-every plugin should override. An example of this can be found below:</p>
+<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, a forwarded <a
href="https://developer.android.com/reference/android/app/Activity#onRequestPermissionsResult(int,%20java.lang.String[],%20int[])">Android
method</a>, which every plugin should override. An example of this can be
found below:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kt">void</span> <span class="nf">onRequestPermissionResult</span><span
class="o">(</span><span class="kt">int</span> <span
class="n">requestCode</span><span class="o">,</span> <span
class="nc">String</span><span class="o">[]</span> <span
class="n">permissions</span><span class="o">,</span>
- <span class="kt">int</span><span
class="o">[]</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="kd">throws</span> <span class="nc">JSONException</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Override</span>
+<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">onRequestPermissionResult</span><span class="o">(</span><span
class="kt">int</span> <span class="n">requestCode</span><span
class="o">,</span> <span class="nc">String</span><span class="o">[]</span>
<span class="n">permissions</span><span class="o">,</span> <span
class="kt">int</span><span class="o">[]</span> <span
class="n">grantResults</span><span class="o">)</span> <span
class="kd">throws</span> <span class=" [...]
<span class="o">{</span>
- <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="nl">r:</span><span
class="n">grantResults</span><span class="o">)</span>
+ <span class="c1">// It is possible that the permissions request
interaction with the user is interrupted.</span>
+ <span class="c1">// In this case you will receive an empty permissions and
grantResults array, which should be</span>
+ <span class="c1">// treated as a cancellation.</span>
+ <span class="kt">boolean</span> <span class="n">granted</span> <span
class="o">=</span> <span class="n">grantResults</span><span
class="o">.</span><span class="na">length</span> <span class="o">!=</span>
<span class="mi">0</span><span class="o">;</span>
+
+ <span class="c1">// Check if a permission is denied by user</span>
+ <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="n">grantResult</span> <span
class="o">:</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">if</span><span class="o">(</span><span
class="n">r</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
+ <span class="k">if</span><span class="o">(</span><span
class="n">grantResult</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span> [...]
- <span class="k">return</span><span class="o">;</span>
+ <span class="n">granted</span> <span class="o">=</span> <span
class="kc">false</span><span class="o">;</span>
+ <span class="k">break</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
+
+ <span class="c1">// User denied a permission</span>
+ <span class="k">if</span><span class="o">(!</span><span
class="n">granted</span><span class="o">)</span>
+ <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span><spa [...]
+ <span class="k">return</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c1">// Handle the request with the granted permission</span>
<span class="k">switch</span><span class="o">(</span><span
class="n">requestCode</span><span class="o">)</span>
<span class="o">{</span>
<span class="k">case</span> <span class="nl">SEARCH_REQ_CODE:</span>
diff --git a/docs/en/dev/guide/platforms/android/plugin.html
b/docs/en/dev/guide/platforms/android/plugin.html
index b55f85669e..a322c39a72 100644
--- a/docs/en/dev/guide/platforms/android/plugin.html
+++ b/docs/en/dev/guide/platforms/android/plugin.html
@@ -2676,20 +2676,34 @@ documentation <a
href="https://developer.android.com/guide/topics/security/permi
<span class="o">}</span>
</code></pre></div></div>
-<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, which
-every plugin should override. An example of this can be found below:</p>
+<p>This will call the activity and cause a prompt to appear, asking for the
permission. Once the user has the permission, the result must be handled with
the <code>onRequestPermissionResult</code> method, a forwarded <a
href="https://developer.android.com/reference/android/app/Activity#onRequestPermissionsResult(int,%20java.lang.String[],%20int[])">Android
method</a>, which every plugin should override. An example of this can be
found below:</p>
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="kd">public</span> <span
class="kt">void</span> <span class="nf">onRequestPermissionResult</span><span
class="o">(</span><span class="kt">int</span> <span
class="n">requestCode</span><span class="o">,</span> <span
class="nc">String</span><span class="o">[]</span> <span
class="n">permissions</span><span class="o">,</span>
- <span class="kt">int</span><span
class="o">[]</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="kd">throws</span> <span class="nc">JSONException</span>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nd">@Override</span>
+<span class="kd">public</span> <span class="kt">void</span> <span
class="nf">onRequestPermissionResult</span><span class="o">(</span><span
class="kt">int</span> <span class="n">requestCode</span><span
class="o">,</span> <span class="nc">String</span><span class="o">[]</span>
<span class="n">permissions</span><span class="o">,</span> <span
class="kt">int</span><span class="o">[]</span> <span
class="n">grantResults</span><span class="o">)</span> <span
class="kd">throws</span> <span class=" [...]
<span class="o">{</span>
- <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="nl">r:</span><span
class="n">grantResults</span><span class="o">)</span>
+ <span class="c1">// It is possible that the permissions request
interaction with the user is interrupted.</span>
+ <span class="c1">// In this case you will receive an empty permissions and
grantResults array, which should be</span>
+ <span class="c1">// treated as a cancellation.</span>
+ <span class="kt">boolean</span> <span class="n">granted</span> <span
class="o">=</span> <span class="n">grantResults</span><span
class="o">.</span><span class="na">length</span> <span class="o">!=</span>
<span class="mi">0</span><span class="o">;</span>
+
+ <span class="c1">// Check if a permission is denied by user</span>
+ <span class="k">for</span><span class="o">(</span><span
class="kt">int</span> <span class="n">grantResult</span> <span
class="o">:</span> <span class="n">grantResults</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">if</span><span class="o">(</span><span
class="n">r</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
+ <span class="k">if</span><span class="o">(</span><span
class="n">grantResult</span> <span class="o">==</span> <span
class="nc">PackageManager</span><span class="o">.</span><span
class="na">PERMISSION_DENIED</span><span class="o">)</span>
<span class="o">{</span>
- <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span> [...]
- <span class="k">return</span><span class="o">;</span>
+ <span class="n">granted</span> <span class="o">=</span> <span
class="kc">false</span><span class="o">;</span>
+ <span class="k">break</span><span class="o">;</span>
<span class="o">}</span>
<span class="o">}</span>
+
+ <span class="c1">// User denied a permission</span>
+ <span class="k">if</span><span class="o">(!</span><span
class="n">granted</span><span class="o">)</span>
+ <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span
class="na">callbackContext</span><span class="o">.</span><span
class="na">sendPluginResult</span><span class="o">(</span><span
class="k">new</span> <span class="nc">PluginResult</span><span
class="o">(</span><span class="nc">PluginResult</span><span
class="o">.</span><span class="na">Status</span><span class="o">.</span><span
class="na">ERROR</span><span class="o">,</span> <span
class="no">PERMISSION_DENIED_ERROR</span><spa [...]
+ <span class="k">return</span><span class="o">;</span>
+ <span class="o">}</span>
+
+ <span class="c1">// Handle the request with the granted permission</span>
<span class="k">switch</span><span class="o">(</span><span
class="n">requestCode</span><span class="o">)</span>
<span class="o">{</span>
<span class="k">case</span> <span class="nl">SEARCH_REQ_CODE:</span>
diff --git a/feed.xml b/feed.xml
index 62bba1b20c..82ee441f85 100644
--- a/feed.xml
+++ b/feed.xml
@@ -6,8 +6,8 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml"; rel="self"
type="application/rss+xml"/>
- <pubDate>Thu, 20 Mar 2025 04:39:52 +0000</pubDate>
- <lastBuildDate>Thu, 20 Mar 2025 04:39:52 +0000</lastBuildDate>
+ <pubDate>Mon, 24 Mar 2025 14:32:32 +0000</pubDate>
+ <lastBuildDate>Mon, 24 Mar 2025 14:32:32 +0000</lastBuildDate>
<generator>Jekyll v4.4.1</generator>
<item>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cordova.apache.org
For additional commands, e-mail: commits-h...@cordova.apache.org
