Query MediaStore for media file URI for setting ringtone

[TranceLove]

Description

With reference to #4367, by inspecting the ringtone settings of a device

settings get system notification_sound

It becomes known that ringtone requires a content URI to the selected audio file on the device.

This PR tries to create that URI by querying the MediaStore. Therefore there is a prerequisite that even the audio file is visible in Amaze, it must also be visible to the MediaStore too, that refreshing the MediaStore is required.

Had attempted to do this for end user in code, but only worked on Android 14 or above, so gave up and not reinvent the wheel instead.

Issue tracker

Fixes #4367

Automatic tests

• Added test cases

Manual tests

• Done

Device:

• Pixel 4 emulator running Android 9
• Pixel 7 emulator running Android 14

1. Make sure the audio file exists in MediaStore. Some apps like Musicolet can help refresh the MediaStore
2. Open settings -> Sound
3. Change ringtone
4. Choose Amaze when app selection pops up
5. Choose the audio file
6. Ringtone name should shown equal to filename without extension, and no Toast pops up
7. Call the device
8. Device should ring without crashing any app

Build tasks success

Successfully running following tasks on local:

• ./gradlew assembledebug
• ./gradlew spotlessCheck

[Copilot]

Pull Request Overview

This PR adds logic to query MediaStore for the correct content URI when setting a custom ringtone and updates media-scanning utilities to handle multiple files more idiomatically.

• Adds a new string resource for MediaStore URI query errors
• Implements MediaStoreHack.getUriForMusicMediaFrom and integrates it in MainFragment to build the ringtone URI
• Renames and refactors MediaConnectionUtils.scanFile to scanFiles and updates all call sites accordingly

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
app/src/main/res/values/strings.xml	Added error.mediastore.query.uri message
app/src/main/java/com/amaze/filemanager/ui/fragments/MainFragment.java	Queries MediaStore for ringtone URI; handles null fallback
app/src/main/java/com/amaze/filemanager/filesystem/files/MediaConnectionUtils.kt	Renamed scanFile → scanFiles; updated implementation
app/src/main/java/com/amaze/filemanager/filesystem/MediaStoreHack.java	Added getUriForMusicMediaFrom helper
Multiple *.java / *.kt files	Replaced all scanFile calls with scanFiles

Comments suppressed due to low confidence (3)

app/src/main/res/values/strings.xml:851

• Resource names cannot contain dots; this will cause a build error. Rename to error_mediastore_query_uri to match Android resource naming conventions and the usage in code (R.string.error_mediastore_query_uri).

<string name="error.mediastore.query.uri">Error querying MediaStore for content URI of select media file. Refresh the MediaStore and try again.</string>

app/src/main/java/com/amaze/filemanager/filesystem/MediaStoreHack.java:168

• [nitpick] The method name getUriForMusicMediaFrom is redundant. Consider renaming to getUriForMusicMedia or getMusicMediaUri for conciseness and consistency.

public static Uri getUriForMusicMediaFrom(@NonNull String path, @NonNull Context context) {

app/src/main/java/com/amaze/filemanager/filesystem/MediaStoreHack.java:168

• You’ve added new query logic in MediaStoreHack but no unit or integration tests cover successful and failed query paths. Consider adding tests to verify both returned URIs and null behavior.

public static Uri getUriForMusicMediaFrom(@NonNull String path, @NonNull Context context) {

[Copilot]

[nitpick] Calling finish() here abruptly ends the host activity. Consider setting a canceled result (e.g., setResult(RESULT_CANCELED)) so the ringtone picker can handle the fallback gracefully instead of closing the entire app.

Suggested change

	.show();
	.show();
	requireActivity().setResult(FragmentActivity.RESULT_CANCELED);

[Copilot]

The KDoc comment above still refers to scanFile(...). Update it to reflect the new scanFiles(...) method name and its parameters for clarity.

[Copilot]

Using a generic "audio/*" MIME type may not convey the exact format. Consider retrieving the specific MIME type (e.g., via MimeTypes.getMimeType) to improve compatibility with clients expecting precise types.

Suggested change

	intent.setDataAndType(properUri, "audio/*");
	String mimeType = MimeTypes.getMimeType(resultBaseFile.getPath());
	intent.setDataAndType(properUri, mimeType != null ? mimeType : "audio/*");