Android读取手机目录图片遇问题：DOWNLOAD字段无法识别

Hey there! Let's break down your issues step by step since you're new to Android development—no worries, we've all been there.

1. Fixing the unrecognized filePaths.DOWNLOAD issue #

The root cause here is that your FilePaths class doesn't define a DOWNLOAD constant (or a SCREENSHOTS one, if you want to add that too). You need to add these using Android's built-in Environment class to get standard public directories (avoid hardcoding paths, since they can vary across devices):

public class FilePaths {
    // Keep your existing constants like CAMERA, PICTURES
    public static final String CAMERA = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM).getAbsolutePath() + "/Camera";
    public static final String PICTURES = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).getAbsolutePath();

    // Add these for Download and Screenshots
    public static final String DOWNLOAD = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).getAbsolutePath();
    public static final String SCREENSHOTS = PICTURES + "/Screenshots"; // Screenshots are usually under Pictures
}

Once you add these, Android Studio will recognize filePaths.DOWNLOAD and filePaths.SCREENSHOTS without issues.

2. Fixing inability to read Download/Screenshots directories #

There are two main reasons this might be happening: missing permissions, or issues with your FileSearch utility class.

a. Check and request storage permissions

Android 6.0+ (API 23+) requires runtime permissions to access external storage. For Android 13+, you can use the more granular READ_MEDIA_IMAGES permission instead of READ_EXTERNAL_STORAGE.

First, add permissions to your AndroidManifest.xml:

<!-- For Android <13 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- For Android 13+ -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" android:minSdkVersion="33" />

Then, add runtime permission checking to your GalleryFragment before calling init():

private static final int REQUEST_STORAGE_PERMISSION = 100;

@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fragment_gallery, container, false);
    // ... your existing view initialization code ...

    // Check permission first before initializing
    checkStoragePermission();
    return view;
}

private void checkStoragePermission() {
    boolean hasPermission;
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        hasPermission = ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.READ_MEDIA_IMAGES) == PackageManager.PERMISSION_GRANTED;
    } else {
        hasPermission = ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
    }

    if (!hasPermission) {
        String[] permissions = Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU 
            ? new String[]{Manifest.permission.READ_MEDIA_IMAGES} 
            : new String[]{Manifest.permission.READ_EXTERNAL_STORAGE};
        
        ActivityCompat.requestPermissions(getActivity(), permissions, REQUEST_STORAGE_PERMISSION);
    } else {
        // Permission granted, proceed with init
        init();
    }
}

// Handle permission request result
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            init();
        } else {
            // Show a message to user that permission is needed
            Toast.makeText(getActivity(), "Storage permission is required to access images", Toast.LENGTH_SHORT).show();
        }
    }
}

b. Verify your FileSearch class logic

Your FileSearch.getFilePaths() method might not be filtering for image files correctly, or might be failing to read directories. Make sure it only includes valid image files (like .jpg, .png, .jpeg) and handles null directory listings safely:

public class FileSearch {
    public static ArrayList<String> getDirectoryPaths(String directory) {
        ArrayList<String> directories = new ArrayList<>();
        File file = new File(directory);
        File[] listFiles = file.listFiles();
        if (listFiles != null) {
            for (File f : listFiles) {
                if (f.isDirectory()) {
                    directories.add(f.getAbsolutePath());
                }
            }
        }
        return directories;
    }

    public static ArrayList<String> getFilePaths(String directory) {
        ArrayList<String> imagePaths = new ArrayList<>();
        File file = new File(directory);
        File[] listFiles = file.listFiles();
        if (listFiles != null) {
            for (File f : listFiles) {
                // Only add image files
                if (f.isFile() && isImageFile(f.getName())) {
                    imagePaths.add(f.getAbsolutePath());
                }
            }
        }
        return imagePaths;
    }

    // Helper to check if a file is an image
    private static boolean isImageFile(String fileName) {
        String[] validExtensions = {"jpg", "jpeg", "png", "gif", "webp"};
        String fileExtension = fileName.substring(fileName.lastIndexOf(".") + 1).toLowerCase();
        for (String ext : validExtensions) {
            if (ext.equals(fileExtension)) {
                return true;
            }
        }
        return false;
    }
}

c. Add Screenshots directory to your list

Don't forget to add the Screenshots directory to your directories list in init():

directories.add(filePaths.CAMERA);
directories.add(filePaths.DOWNLOAD);
directories.add(filePaths.SCREENSHOTS); // Add this line

3. Bonus: Scoped Storage compatibility (Android 10+) #

For Android 10 (API 29) and above, Google introduced Scoped Storage which restricts direct access to external storage directories. While your current approach might work if you set android:requestLegacyExternalStorage="true" in your AndroidManifest.xml (inside the <application> tag), the long-term solution is to use the MediaStore API to query images instead of directly accessing files. This avoids permission issues and is more future-proof.

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