Skip to content

feat(ci): add Android (aarch64) cross-compilation for Termux users#1470

Merged
houko merged 5 commits intomainfrom
feat/886-android-build
Mar 22, 2026
Merged

feat(ci): add Android (aarch64) cross-compilation for Termux users#1470
houko merged 5 commits intomainfrom
feat/886-android-build

Conversation

@houko
Copy link
Copy Markdown
Contributor

@houko houko commented Mar 22, 2026

Summary

Closes #886

  • Add aarch64-linux-android target to Cross.toml using the official cross-rs Android image
  • Add cli_android job to release-shell.yml that cross-compiles the CLI binary for Android ARM64 and uploads it to GitHub Releases
  • Add Android/Termux setup documentation (English + Chinese) covering installation, configuration, usage, and troubleshooting
  • Register the new docs page in the navigation sidebar

Details

The goal is to let Termux users on Android download a pre-built binary from releases without needing to compile from source. The CI job uses cross (cross-rs/cross) with the ghcr.io/cross-rs/aarch64-linux-android:main image and produces a librefang-aarch64-linux-android.tar.gz artifact.

Test plan

  • Verify CI workflow syntax is valid (GitHub Actions will validate on PR)
  • After merge and tag push, confirm the cli_android job runs and uploads the artifact
  • Download the artifact on an Android/Termux device and verify ./librefang --version works

)

- Add aarch64-linux-android target to Cross.toml
- Add cli_android job to release-shell.yml workflow
- Add Android/Termux setup docs (EN + ZH) with installation,
  configuration, and troubleshooting guides
- Register new docs page in navigation sidebar
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@github-actions github-actions Bot added area/docs Documentation and guides area/ci CI/CD and build tooling labels Mar 22, 2026
@houko houko merged commit 86adb2b into main Mar 22, 2026
@houko houko deleted the feat/886-android-build branch March 22, 2026 06:19
This was referenced Mar 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ci CI/CD and build tooling area/docs Documentation and guides

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature: Add Android Gateway support

1 participant