Android应用中如何实现已认证SharePoint站点文件下载上传及本地读写

核心问题分析 #

你遇到的问题大概率是三个原因导致：Android 10+对公共存储的访问限制、未正确获取下载文件的真实访问路径、SharePoint下载请求未携带有效认证信息。下面是针对性的解决步骤：

1. 权限配置与动态申请 #

清单文件权限声明 #

在AndroidManifest.xml中添加对应权限：

<!-- Android 9及以下读写公共存储需要 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

<!-- 仅当你必须直接操作整个公共存储时添加（不推荐，Google Play审核严格） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

动态申请权限 #

在代码中针对Android 6.0+动态申请读取权限：

private const val REQUEST_STORAGE_PERMISSION = 1001

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        requestPermissions(arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE), REQUEST_STORAGE_PERMISSION)
    }
}

2. 正确获取Download Manager下载文件的访问路径 #

Android 10+禁止直接通过File类访问公共目录（包括Download文件夹），必须通过Content URI + ContentResolver进行读写。下载完成后，不要直接拼接文件路径，而是从Download Manager的查询结果中获取Content URI：

val downloadManager = getSystemService(DOWNLOAD_SERVICE) as DownloadManager
val query = DownloadManager.Query().setFilterById(yourDownloadId) // yourDownloadId是enqueue返回的ID
val cursor = downloadManager.query(query)

if (cursor.moveToFirst()) {
    val uriColumnIndex = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)
    val fileUri = Uri.parse(cursor.getString(uriColumnIndex))
    
    // 读取文件示例
    contentResolver.openInputStream(fileUri)?.use { inputStream ->
        // 处理输入流，比如复制到应用私有目录：
        val privateFile = File(filesDir, "copied_file.ext")
        FileOutputStream(privateFile).use { outputStream ->
            inputStream.copyTo(outputStream)
        }
    }
    
    // 写入文件示例（如需修改下载后的文件）
    contentResolver.openOutputStream(fileUri)?.use { outputStream ->
        // 写入内容到文件
    }
}
cursor.close()

3. 确保SharePoint下载请求携带有效认证 #

SharePoint需要身份验证，若下载请求未携带正确的认证头，你下载的可能是未授权页面而非目标文件，导致系统提示"文件不存在"。在构建Download Manager请求时添加认证头：

val sharePointFileUrl = "你的SharePoint文件URL"
val accessToken = "你的SharePoint访问令牌"

val request = DownloadManager.Request(Uri.parse(sharePointFileUrl))
    .addRequestHeader("Authorization", "Bearer $accessToken") // 关键：添加认证头
    .setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "目标文件名.ext")
    .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)

val downloadId = downloadManager.enqueue(request)

4. 常见排查点 #

• 确认下载完成后再尝试读取：可以通过广播接收器监听DownloadManager.ACTION_DOWNLOAD_COMPLETE事件，在下载完成后再执行读写操作。
• 检查下载文件的大小：通过ContentResolver查询文件大小，若为0则说明下载的是无效内容，需排查SharePoint认证问题。
• 避免使用绝对路径访问Download文件夹：Android 10+下Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)返回的路径无法直接通过File类访问。

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