purgatory/ClashMetaForAndroid
1
0
Fork 0
mirror of https://github.com/MetaCubeX/ClashMetaForAndroid.git synced 2024-11-22 05:16:08 +03:00
Code Issues Packages Projects Releases Wiki Activity
Fork of https://github.com/MetaCubeX/ClashMetaForAndroid
385 Commits 5 Branches 136 Tags 7.5 MiB
Kotlin 86.8%
Go 8.4%
C 4.7%
CMake 0.1%
8fa4e33bda
Go to file
Το μοχθηρό ^_^ 8fa4e33bda Update dependency (#174) 
* Add renovate.json

* fix(deps): update dependency org.jetbrains.kotlinx:kotlinx-coroutines-android to v1.7.3

* chore(deps): update dependency gradle to v7.6.3

* chore(deps): update devofure/advance-android-version-actions action to v1.5

* chore(deps): update mikepenz/release-changelog-builder-action action to v3.7.3

* chore(deps): update actions/upload-artifact action to v4

* chore(deps): update mikepenz/release-changelog-builder-action action to v4

* chore(deps): update actions/setup-go action to v5

* chore(deps): update actions/setup-java action to v4

* chore(deps): update actions/cache action to v4

* chore(deps): update actions/checkout action to v4

* chore(deps): update tibdex/github-app-token action to v2

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2024-01-18 09:54:42 +00:00
.github Update dependency (#174) 2024-01-18 09:54:42 +00:00
.idea/codeStyles feat: show subscription 2022-12-10 10:17:58 +08:00
app Update Dependencies (#1) 2024-01-18 09:54:32 +00:00
common feat: add intent filters for tasker automation (#119) 2023-11-01 12:00:37 +08:00
core Update Dependencies (#1) 2024-01-18 09:54:32 +00:00
design feat: add some override options about sniffing 2023-11-02 18:57:55 +08:00
fastlane/metadata/android fastlane: fix a typo 2022-07-06 19:39:07 +08:00
gradle/wrapper Update dependency (#174) 2024-01-18 09:54:42 +00:00
hideapi Refactor: refactor project structure & update clash core (#1174) 2021-09-11 14:53:09 +08:00
service feat: show toast after profile updated 2023-10-31 23:04:26 +08:00
.gitattributes Chore: add .gitattributes (#1191) 2021-09-13 18:34:34 +08:00
.gitignore Squashed commit of the following: 2023-10-29 21:38:36 +08:00
.gitmodules 更换核心地址 2024-01-17 05:59:44 +00:00
build.gradle.kts chore: update version 2023-11-02 19:17:58 +08:00
CONTRIBUTING.md Chore: update CONTRIBUTING.md 2021-05-15 02:01:38 +08:00
gradle.properties Chore: remove unused dependencies & improve gradle properties & code style (#1189) 2021-09-13 17:49:23 +08:00
gradlew Chore: update dependencies 2021-11-14 19:17:06 +08:00
gradlew.bat Chore: update gradle wrapper & append sha256sum 2021-05-15 19:15:43 +08:00
LICENSE Initial: initial commit 2021-05-15 00:51:08 +08:00
NOTICE Initial: initial commit 2021-05-15 00:51:08 +08:00
PRIVACY_POLICY.md Initial: initial commit 2021-05-15 00:51:08 +08:00
README.md action: better release action 2023-11-03 01:53:59 +08:00
release.keystore Add files via upload 2022-06-18 07:22:07 +07:00
renovate.json Update dependency (#174) 2024-01-18 09:54:42 +00:00
settings.gradle.kts Update dependency (#174) 2024-01-18 09:54:42 +00:00

README.md

Clash Meta for Android

A Graphical user interface of Clash.Meta for Android

Feature

Feature of Clash.Meta

Get it on F-Droid

Requirement

  • Android 5.0+ (minimum)
  • Android 7.0+ (recommend)
  • armeabi-v7a , arm64-v8a, x86 or x86_64 Architecture

Build

  1. Update submodules

    git submodule update --init --recursive

  2. Install OpenJDK 11, Android SDK, CMake and Golang

  3. Create local.properties in project root with

    sdk.dir=/path/to/android-sdk

  4. Create signing.properties in project root with

    keystore.path=/path/to/keystore/file
keystore.password=<key store password>
key.alias=<key alias>
key.password=<key password>

  5. Build

    ./gradlew app:assembleMeta-AlphaRelease

Automation

APP package name is com.github.metacubex.clash.meta

  • Toggle Clash.Meta service status
    • Send intent to activity com.github.kr328.clash.ExternalControlActivity with action com.github.metacubex.clash.meta.action.TOGGLE_CLASH
  • Start Clash.Meta service
    • Send intent to activity com.github.kr328.clash.ExternalControlActivity with action com.github.metacubex.clash.meta.action.START_CLASH
  • Stop Clash.Meta service
    • Send intent to activity com.github.kr328.clash.ExternalControlActivity with action com.github.metacubex.clash.meta.action.STOP_CLASH
  • Import a profile
    • URL Scheme clash://install-config?url=<encoded URI> or clashmeta://install-config?url=<encoded URI>

Contribution and Project Maintainance

Meta Kernel

  • CMFA uses the kernel from android-real branch under MetaCubeX/Clash.Meta, which is a merge of the main Alpha branch and android-open.
    • If you want to contribute to the kernel, make PRs to Alpha branch of the Meta kernel repository.
    • If you want to contribute Android-specific patches to the kernel, make PRs to android-open branch of the Meta kernel repository.

Maintainance

  • When MetaCubeX/Clash.Meta kernel is updated to a new version, the Update Dependencies actions in this repo will be triggered automatically.
    • It will pull the new version of the meta kernel, update all the golang dependencies, and create a PR without manual intervention.
    • If there is any compile error in PR, you need to fix it before merging. Alternatively, you may merge the PR directly.
  • Manually triggering Build Pre-Release actions will compile and publish a PreRelease version.
  • Manually triggering Build Release actions will compile, tag and publish a Release version.
    • You must fill the blank Release Tag with the tag you want to release in the format of v1.2.3.
    • versionName and versionCode in build.gradle.kts will be automatically bumped to the tag you filled above.