# wails-android-example

**Repository Path**: EEPPEE_admin/wails-android-example

## Basic Information

- **Project Name**: wails-android-example
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: wails

## README

# Hello World Mobile Sample

A minimal mobile Go example packaged for Android using `gomobile bind`.

## Structure

- `engine.go` — app startup and runtime registration, not meant to be tampered unless you are sure
- `main.go` — backend service with `AppService.SayHello`
- `frontend/` — embedded web UI assets
- `android/` — local Android build helper scripts

## Refresh or Sync workflow

After editing or write your Go code, you must refresh or sync first to produce native bindings.

Update `android.ini` to control architecture, Android API, output path, and template SDK values.

```bash
wailsm --refresh android # or ios

```

The script will:

- build the example AAR with `gomobile bind`
- dump the generated `.aar` and source `.jar` into `native/android/app/libs`


## Building the App

Once again: don't forget after editing or write your Go code, you must refresh or sync first to produce native bindings.

Now open the project in Android Studio or XCode.

Where the resulting projects are found:
 - Final Android Studio project: `native/android/`
 - Final XCode: `native/...`

---

## Adding external Plugins

External plugins are just external Go packages, with the directory structured in such a way Wails Mobile CLI can realize it contains some native platform code. 

Sample Plugin structure:

```bash
somePlugin/
    - android/
        - com/.... #example package name
    - ios/
        - ...#support coming soon
    
    - go.mod
    - other go package files
```

You can add a plugin with:
```bash
wailsm --add github.com/<handle>/<plugin> # uses `go get...` under the hood
```

## Removing packages
You can remove a plugin from Wails mobile with:
```bash
wailsm --remove github.com/<handle>/<plugin>
```

## Writing custom plugins or Native code

You can design an external plugin to be integrated into Wails Mobile application, or even write some app-specific native Java or Swift code and call it from Go. 

Instructions on achieving this goal is wired in `[PLUGINS.md](PLUGINS.md)`

---

## Notes

- The WebView frontend uses `WailsBind.callGo(...)` to invoke the Go backend.
- Currently, `wails-mobile` is stable enough for Android builds. If you care to get support for iOS sooner, contribute by translating the Java project into Swift project. 
- The core bridge in Go is cross-platform(`Android` and `iOS`). No writing of JNI. No writing of *C* code and headers.