安卓App Links实现浏览器传文件至APP并返回结果的问题排查

核心场景 #

需开发安卓应用，实现以下功能：接收浏览器共享的文件、从深度链接获取操作指令，处理后返回结果文件。当前配置了Intent Filter，HTML端通过window.location.href跳转自定义Scheme链接，但点击按钮无反应；用adb测试深度链接可正常唤醒应用。

第一步：排查浏览器端跳转问题 #

1. 浏览器对自定义Scheme的安全限制 #

现代浏览器（Chrome、Edge等）对非HTTP/HTTPS的Scheme跳转有严格限制，即使在用户点击事件内触发，也可能被拦截。可以尝试替换window.location.href的方式，改用模拟标签点击的方式触发跳转：

document.getElementById('sendButton').addEventListener('click', function() {
    const fileInput = document.getElementById('fileInput');
    if (fileInput.files.length > 0) {
        const file = fileInput.files[0];
        const url = `app://action?operation=sign&filename=${encodeURIComponent(file.name)}`;
        
        // 改用a标签模拟点击
        const link = document.createElement('a');
        link.href = url;
        link.style.display = 'none';
        document.body.appendChild(link);
        link.click();
        document.body.removeChild(link);
    } else {
        alert('Please select a file first.');
    }
});

2. 浏览器应用关联权限 #

部分浏览器会询问用户是否允许打开第三方应用，若之前误点“拒绝”，后续跳转将被拦截。可在浏览器设置中找到「应用关联」「默认应用」选项，检查你的应用是否被允许处理app://链接。

3. 跨浏览器测试 #

换用系统自带浏览器、Firefox等不同浏览器测试跳转，排除特定浏览器的兼容性问题。

第二步：验证链接与Intent Filter的匹配性 #

用adb测试完全相同的生成链接，确认Intent Filter配置无误：

adb shell am start -a android.intent.action.VIEW -d "app://action?operation=sign&filename=test.txt"

若adb能正常唤醒应用，说明链接格式与Manifest配置匹配，问题集中在浏览器端；若adb也无法唤醒，需检查Manifest中Activity名称是否正确（当前配置的android:name="activity"应为完整类名，比如.MainActivity）。

方案可行性分析 #

你当前的方案无法实现“获取浏览器文件内容”的核心需求：深度链接只能传递文件名、操作指令等字符串参数，无法直接传递浏览器中的File对象数据。即使跳转成功，应用也只能拿到文件名，无法获取实际文件内容。

替代实现方案 #

1. 使用Web Share Target API（推荐） #

安卓支持Web Share Target，可让浏览器直接将文件共享给应用，无需通过深度链接传递文件名。

• 在AndroidManifest.xml中配置Share Target的Intent Filter：

<activity android:name=".FileShareActivity">
    <intent-filter>
        <action android:name="android.intent.action.SEND" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="*/*" /> <!-- 根据支持的文件类型调整，比如application/pdf -->
    </intent-filter>
</activity>

• 在Activity中获取文件Uri并读取内容：

Intent intent = getIntent();
if (Intent.ACTION_SEND.equals(intent.getAction())) {
    Uri fileUri = intent.getParcelableExtra(Intent.EXTRA_STREAM);
    if (fileUri != null) {
        // 通过ContentResolver读取文件内容
        InputStream inputStream = getContentResolver().openInputStream(fileUri);
        // 后续处理逻辑
    }
}

• 网页端可通过Web Share API触发共享：

document.getElementById('sendButton').addEventListener('click', function() {
    const fileInput = document.getElementById('fileInput');
    if (fileInput.files.length > 0) {
        const file = fileInput.files[0];
        // 传递文件+操作指令
        navigator.share({
            files: [file],
            title: 'File to process',
            text: 'operation=sign' // 这里传递操作指令，应用端从EXTRA_TEXT获取
        }).catch(err => console.error('Share failed:', err));
    } else {
        alert('Please select a file first.');
    }
});

2. 服务器中转方案 #

若需保留深度链接逻辑，可让网页将文件上传至你的服务器，然后通过深度链接传递服务器上的文件URL，应用端下载后处理。但此方案依赖服务器支持，且存在文件传输耗时问题。

3. Android Custom Tabs（适用于自有网页） #

若网页属于你的应用生态，可使用Custom Tabs打开网页，通过Custom Tabs的回调接口与应用通信，直接传递文件数据或操作指令。

内容的提问来源于stack exchange，提问作者monteg