base on Husi(虎兕) is a Non-professional and Recreational Proxy Tool Integration. <a href="https://apt.izzysoft.de/fdroid/index/apk/fr.husi/"> <img src="https://gitlab.com/IzzyOnDroid/repo/-/raw/master/assets/IzzyOnDroid.png" alt="Get it on IzzyOnDroid" height="80"> </a> ## 🛠️ Contribution ## 🧭 Guide [CONTRIBUTING](./CONTRIBUTING.md) ### 📚 Localization Is husi not in your language, or the translation is incorrect or incomplete? Get involved in the translations on our [Weblate](https://hosted.weblate.org/engage/husi/). [](https://hosted.weblate.org/engage/husi/) ### 🔨 Learn to Compilation In Linux, you can build husi reproducibly for release version. For this, you should use the same version of JDK, NDK as below. And Go version should as same as [version.sh](./buildScript/init/version.sh). #### 🧰 Get the Source Code ```shell git clone https://github.com/xchacha20-poly1305/husi.git --depth=1 cd husi/ ./run lib source # Will help you to get submodules ``` #### ⚖️ libcore Environment: * These versions need to apply patch. <details> <summary>Unfold</summary> 1.22.5: Apply [this patch](./libcore/patches/cgo_go1225.diff) to `${GOROOT}/src/runtime/cgocall.go` 1.23.0-1.23.3: Apply [this patch](https://github.com/golang/go/commit/76a8409eb81eda553363783dcdd9d6224368ae0e.patch) to`${GOROOT}`. `make patch_go1230` 1.23.4: Apply [this patch](https://github.com/golang/go/commit/59b7d40774b29bd1da1aa624f13233111aff4ad2.patch) to `$(GOROOT)`. `make patch_go1234` </details> * Openjdk-21 (Later may OK, too.) Run: ```shell make libcore ``` This will generate `app/libs/libcore.aar`. If gomobile is not in the GOPATH, it will be automatically downloaded and compiled. If you don't want to build it, you can download then in [actions](https://github.com/xchacha20-poly1305/husi/actions) #### 🎀 Rename package name (optional) If you don't want to use the same package name, you can run `./run rename target_name`. #### 🎁 APK Environment: * jdk-21 * ndk 28.1.13356709 If the environment variables `$ANDROID_HOME` and `$ANDROID_NDK_HOME` are not set, you can run the script `buildScript/init/env_ndk.sh`: ```shell echo "sdk.dir=${ANDROID_HOME}" > local.properties ``` Signing preparation (optional, it is recommended to sign after compilation): Replace `release.keystore` with your own keystore. ```shell echo "KEYSTORE_PASS=" >> local.properties echo "ALIAS_NAME=" >> local.properties echo "ALIAS_PASS=" >> local.properties ``` Download geo resource files: ```shell make assets ``` Compile the release version: ```shell make apk ``` The APK file will be located in `app/build/outputs/apk`. #### 🌈 Plugins ```shell make plugin PLUGIN=<Plugin name> ``` Plugin name list: * `hysteria2` * `juicity` * `naive` ( Deprecated. Build official repository directly, please. ) * `mieru` * `shadowquic` ## ☠️ End users [Wiki](https://github.com/xchacha20-poly1305/husi/wiki) ## 📖 License [GPL-3.0](./LICENSE) ## 🤝 Acknowledgements Core: - [SagerNet/sing-box](https://github.com/SagerNet/sing-box) Android GUI: - [shadowsocks/shadowsocks-android](https://github.com/shadowsocks/shadowsocks-android) - [SagerNet/SagerNet](https://github.com/SagerNet/SagerNet) - [XTLS/AnXray](https://github.com/XTLS/AnXray) - [MatsuriDayo/NekoBoxForAndroid](https://github.com/MatsuriDayo/NekoBoxForAndroid) - [SagerNet/sing-box-for-android](https://github.com/SagerNet/sing-box-for-android) - [AntiNeko/CatBoxForAndroid](https://github.com/AntiNeko/CatBoxForAndroid) - [MetaCubeX/ClashMetaForAndroid](https://github.com/MetaCubeX/ClashMetaForAndroid) - [dyhkwong/Exclave](https://github.com/dyhkwong/Exclave) - [chen08209/FlClash](https://github.com/chen08209/FlClash) Developing - [](https://www.jetbrains.com) JetBrains' powerful IDE.", Assign "at most 3 tags" to the expected json: {"id":"13807","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"