VladPolskiy/nextcloud-documentation
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-07-23 00:48:36 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12075 from nextcloud/add-deep-link-handling-android

Browse Source 
Add Documentation for Android Deep Link Handling
This commit is contained in:
Tobias Kaminsky
2025-06-20 10:26:38 +02:00
committed by GitHub
parent 0dddc168db 5f05fcb472
commit 060f51f9f3
2 changed files with 48 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
admin_manual/configuration_server/android_deep_link_handling.rst Normal file
View File

@ -0,0 +1,47 @@
==========================
Android Deep Link Handling
==========================
Deep linking in Android allows your application to be launched directly from a URL,
making it easier for users to navigate to specific content within your app.
Starting from Android 12, handling deep links requires additional configuration
using an ``assetlinks.json`` file to ensure the app and the host domain are properly
associated.
Android 11 and Below
--------------------
For Android 11 and below, deep linking is straightforward and does not require additional
configuration beyond the usual manifest settings.
Android 12 and Above
--------------------
For Android 12 and above, an additional configuration step is required to verify the
relationship between your app and the host domain using the ``assetlinks.json`` file.
Creating assetlinks.json
~~~~~~~~~~~~~~~~~~~~~~~~
Create a file named ``assetlinks.json`` and host it in the .well-known directory of
your website (e.g., https://www.cloud.example.com/.well-known/assetlinks.json).
Example ``assetlinks.json``::
[
{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.cloud.example.nextcloud",
"sha256_cert_fingerprints": [
"FB:00:95:22:F6:5E:25:80:22:61:B6:7B:10:A4:5F:D7:0E:61:00:31:97:6F:40:B2:8A:64:9E:15:2D:ED:03:73"
]
}
}
]
Nextcloud Configuration Limitation
==================================
Due to the additional requirement of hosting an ``assetlinks.json`` file
for Android 12 and above, Nextcloud cannot configure the Android client
for all different hosts. This is because each host needs its own ``assetlinks.json``
file to establish a verified relationship with the app, and Nextcloud cannot manage
this file for every possible host domain.

1
go.php
View File

@ -55,6 +55,7 @@ $mapping = array(
'admin-warnings' => '/admin_manual/configuration_server/security_setup_warnings.html',
'admin-windows-compatible-filenames' => '/admin_manual/configuration_files/windows_compatible_filenames.html',
'admin-workflowengine' => '/admin_manual/file_workflows/index.html',
'admin-android-deep-link-handling' => 'admin_manual/configuration_server/android_deep_link_handling.html',
'developer-manual' => '/developer_manual',
'developer-backports' => '/developer_manual/getting_started/development_process.html#bugfixes',