[v3] File picker fields do not function on android

[hypherionmc]

Wails version family

v3

Operating System

Android (experimental)

Description

Before I start off this report, yes I am aware that a native File select dialog exists, but in this case it's MUCH more of a hassle to implement and use, since I need access to things only provided through the html file field (for example being able to show image previews of selected images, the size, and being able to upload the file along with a form).

When you have an HTML file field inside the app, clicking it does nothing. There are no errors, messages or anything else logged in the debug console either.

Through the normal desktop versions, it works as expected.

As far as I am aware, the web engine on android (not sure which one exactly wails uses), is capable of doing this, but support for it needs to implemented.

To Reproduce

1. Clone the Android example as per this GitHub repo
2. Add a simple <input type="file" /> field into it
3. Launch the app through the emulator, or a real device and click the input. Nothing happens

Expected behaviour

To have the same, or similar response as to what happens when you click on such a field in the mobile browser, or mostly any other android app that runs in a webview

Screenshots

No response

Attempted Fixes

I have tried to just use the native file dialogs, but as mentioned earlier, this is much more of a hassle to maintain and implement, when it would specifically only apply to android

System Details

Wails v3.0.0-alpha2.105 › Wails Doctor
                                                                                                                                                                                                                                    
# System
        
┌────────────────────────────────────────────────────────────────────┐
| Name                | LunaWolf Linux                               |
| Version             | Unknown                                      |
| ID                  | lunawolf                                     |
| Branding            |                                              |
| Platform            | linux                                        |
| Architecture        | amd64                                        |
| Desktop Environment | KDE                                          |
| NVIDIA Driver       | 580.119.02 (98F03F1FC7BAA1EA7283C59)         |
| XDG_SESSION_TYPE    | wayland                                      |
| CPU                 | AMD Ryzen 5 5500                             |
| GPU                 | GM206 [GeForce GTX 950] (NVIDIA Corporation) |
| Memory              | 32GB                                         |
└────────────────────────────────────────────────────────────────────┘
                   
# Build Environment
                   
┌──────────────────────────────────┐
| Wails CLI    | v3.0.0-alpha2.105 |
| Go Version   | go1.25.0          |
| -buildmode   | exe               |
| -compiler    | gc                |
| CGO_CFLAGS   |                   |
| CGO_CPPFLAGS |                   |
| CGO_CXXFLAGS |                   |
| CGO_ENABLED  | 1                 |
| CGO_LDFLAGS  |                   |
| GOAMD64      | v1                |
| GOARCH       | amd64             |
| GOOS         | linux             |
└──────────────────────────────────┘
              
# Dependencies
              
┌──────────────────────────────────────────────────────────────────────────────────────────────┐
| *Android NDK            | /home/hypherionsa/Android/Sdk/ndk/30.0.14904198                    |
| *Android SDK            | /home/hypherionsa/Android/Sdk                                      |
| *Android platform-tools | Installed                                                          |
| *Java (Android)         | openjdk version "17.0.19" 2026-04-21                               |
| gcc                     | 16.1.1+r12+g301eb08fa2c5-1                                         |
| gtk3 (legacy)           | 1:3.24.52-1                                                        |
| gtk4                    | 1:4.22.4-1                                                         |
| npm                     | 10.9.8                                                             |
| pkg-config              | 2.5.1-1                                                            |
| webkit2gtk (legacy)     | 2.52.4-1                                                           |
| webkitgtk-6.0           | 2.52.4-1                                                           |
| docker                  | *Docker version 29.5.2, build 79eb04c7d8 (cross-compilation ready) |
|                                                                                              |
└────────────────────────────────── * - Optional Dependency ───────────────────────────────────┘
         
# Signing
         
┌─────────────────────────────────────────────┐
| macOS Signing   | Not configured            |
| Windows Signing | Not configured            |
| Linux Signing   | GPG key: AA2319E4D334290A |
└─────────────────────────────────────────────┘
                     
# Checking for issues
                     
 SUCCESS  No issues found
           
# Diagnosis
           
 SUCCESS  Your system is ready for Wails development!

Need documentation? Run: wails3 docs
 ♥   If Wails is useful to you or your company, please consider sponsoring the project: wails3 sponsor


(The OS is a custom Arch Based distro)

Additional context

No response

[hypherionmc]

I kinda got it to work, using a workaround. Leaving it here in case someone else runs into the same issue.

If the maintainers want, I will provide a PR for this (unless they have concerns or a different way of doing it).

In build/android/app/src/main/java/com/wails/app/MainActivity.java add the following:

• Near the top of the file

private android.webkit.ValueCallback<android.net.Uri[]> uploadMessage;
private static final int FILECHOOSER_RESULTCODE = 1;

• Underneath webview.addJavascriptInterface(new WailsJSBridge(bridge, webview), "wails"); add:

webView.setWebChromeClient(new android.webkit.WebChromeClient() {
    @Override
    public boolean onShowFileChooser(android.webkit.WebView webView, android.webkit.ValueCallback<android.net.Uri[]> filePathCallback, android.webkit.WebChromeClient.FileChooserParams fileChooserParams) {
        if (uploadMessage != null) {
            uploadMessage.onReceiveValue(null);
        }
        uploadMessage = filePathCallback;

        android.content.Intent intent = fileChooserParams.createIntent();
        try {
            startActivityForResult(intent, FILECHOOSER_RESULTCODE);
        } catch (android.content.ActivityNotFoundException e) {
            uploadMessage = null;
            return false;
        }
        return true;
    }
});

Finally, in onActivityResult apply these changes:

super.onActivityResult(requestCode, resultCode, data);
- if (requestCode != FILE_PICKER_REQUEST) {
-     return;
- }
+
+  if (requestCode == FILECHOOSER_RESULTCODE) {
+     if (uploadMessage == null) return;
+     android.net.Uri[] results = android.webkit.WebChromeClient.FileChooserParams.parseResult(resultCode, data);
+     uploadMessage.onReceiveValue(results);
+     uploadMessage = null;
+ }
+
+ if (requestCode != FILE_PICKER_REQUEST) {
+     return;
+ }

This works for me at least, and "file" fields function as expected