使用SAF设置文档导航初始位置时无法解析EXTRA_INITIAL_URI

你遇到的这个问题，根源主要有两个：一是Intent.EXTRA_INITIAL_URI是**Android 8.0（API级别26）**才新增的系统常量，如果你的项目最低兼容版本低于26，IDE肯定找不到这个符号；二是你自己定义了常量，但代码里还是在引用Intent.EXTRA_INITIAL_URI，而非你自己类里的那个常量，这就导致符号无法匹配。

下面给你分步说明怎么修复：

1. 先确认API级别配置 #

打开你项目的Module级别build.gradle文件，检查minSdkVersion的设置：

android {
    defaultConfig {
        minSdkVersion 26 // 必须至少设为26才能直接用Intent.EXTRA_INITIAL_URI
        // 其他配置...
    }
}

如果你的应用需要兼容API26以下的设备，直接用这个常量就行不通了，可以跳到后面的「低版本兼容方案」。

2. 正确使用常量（API26+适用） #

如果已经把minSdkVersion调整到26或更高，有两种方式解决符号解析问题：

方式一：直接用系统原生常量 #

只要你的SDK依赖是API26及以上，直接用系统提供的Intent.EXTRA_INITIAL_URI即可，不需要自己定义：

intent.putExtra(Intent.EXTRA_INITIAL_URI, uri);

如果IDE还是报错，试试点击Android Studio右上角的「Sync Project with Gradle Files」按钮同步项目，一般就能解决。

方式二：使用自定义常量（如果系统常量仍无法识别） #

如果你自己定义了常量，代码里必须引用当前类的常量，而不是Intent类的：

// 保留你定义的常量
public static final String EXTRA_INITIAL_URI = "android.provider.extra.INITIAL_URI";

// 调用时要指定类名
intent.putExtra(MainActivity.EXTRA_INITIAL_URI, uri);

因为你定义的常量属于MainActivity，不是Intent类的成员，所以直接写Intent.EXTRA_INITIAL_URI肯定找不到符号。

3. 低版本设备的兼容方案 #

如果你的应用必须支持API26以下的设备，EXTRA_INITIAL_URI是用不了的，这时候可以考虑这些替代方案：

• 使用Intent.ACTION_OPEN_DOCUMENT_TREE让用户先选择目标目录，再在回调中处理文件选择逻辑
• 引导用户手动导航到你的应用目录，或者使用成熟的第三方文件选择库来实现初始位置跳转

修复后的完整代码（API26+版本） #

package com.ship.saftwo; 

import android.content.Intent; 
import android.net.Uri; 
import android.os.Environment; 
import android.support.v7.app.AppCompatActivity; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 
import java.io.File; 

public class MainActivity extends AppCompatActivity{ 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main); 
        Button button = (Button) findViewById(R.id.button1); 
        button.setOnClickListener(v -> navigateToAppDirectory());
    } 

    private static final int READ_REQUEST_CODE = 42; 

    public void navigateToAppDirectory() { 
        Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT); 
        String appDirPath = Environment.getExternalStorageDirectory().getPath() 
                + File.separator + getResources().getString(R.string.app_name) 
                + File.separator;
        Uri uri = Uri.parse(appDirPath); 
        intent.addCategory(Intent.CATEGORY_OPENABLE); 
        intent.setType("*/*"); 
        // 使用系统原生常量（确保API26+）
        intent.putExtra(Intent.EXTRA_INITIAL_URI, uri); 
        startActivityForResult(intent, READ_REQUEST_CODE); 
    } 
}

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