tg-ws-proxy-go/android

📱 Android APK Build Guide

Требования

Для сборки Android APK необходимо установить:

1. Android SDK (Android Studio или command-line tools)
2. Go 1.21+
3. gomobile

Установка

1. Установи Android SDK

Вариант A: Android Studio (рекомендуется)

• Скачай: https://developer.android.com/studio
• Установи
• Открой SDK Manager и установи:
  • Android SDK Platform (API 21+)
  • Android SDK Build-Tools
  • Android NDK

Вариант B: Command-line tools только

# Скачай command-line tools
# https://developer.android.com/studio#command-tools

# Распакуй и настрой
export ANDROID_HOME=$HOME/android-sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

2. Установи gomobile

go install golang.org/x/mobile/cmd/gomobile@latest
gomobile init

Сборка APK

Вариант 1: AAR библиотека (для интеграции в Android app)

cd mobile
gomobile bind -target android -o tgwsproxy.aar ./mobile

Получишь tgwsproxy.aar — библиотека для подключения к Android проекту.

Вариант 2: Полное APK приложение

Для создания полноценного APK нужен Android проект с UI.

Структура Android проекта:

android/
├── app/
│   ├── src/main/java/.../MainActivity.java
│   ├── src/main/AndroidManifest.xml
│   └── build.gradle
├── build.gradle
├── settings.gradle
└── tgwsproxy.aar  (из шага выше)

Пример build.gradle:

plugins {
    id 'com.android.application'
}

android {
    compileSdk 34
    defaultConfig {
        applicationId "com.github.yosyatarbeep.tgwsproxy"
        minSdk 21
        targetSdk 34
        versionCode 1
        versionName "1.0"
    }
}

dependencies {
    implementation files('libs/tgwsproxy.aar')
}

Сборка APK:

cd android
./gradlew assembleDebug
# APK будет в: app/build/outputs/apk/debug/app-debug.apk

Быстрая сборка (если есть Android SDK)

# В корне проекта
make android

# Или вручную
gomobile bind -target android -o android/tgwsproxy.aar ./mobile
cd android && ./gradlew assembleDebug

Установка на устройство

adb install app/build/outputs/apk/debug/app-debug.apk

---

📝 Заметки

• Min SDK: Android 5.0 (API 21)
• Target SDK: Android 14 (API 34)
• Архитектуры: arm64-v8a, armeabi-v7a, x86_64
• Размер APK: ~10-15 MB (включая Go runtime)

🔧 Troubleshooting

"Android SDK not found"

# Укажи путь к SDK
export ANDROID_HOME=/path/to/android-sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

"NDK not found"

# Установи NDK через SDK Manager
# Или задай путь
export ANDROID_NDK_HOME=$ANDROID_HOME/ndk/<version>

---

📦 Готовые сборки

Смотри Releases: https://github.com/y0sy4/tg-ws-proxy-go/releases