Atlantis Android

Захватывает HTTP/HTTPS трафик из Android приложений и отправляет в Proxyman для отладки.

Обзор

Atlantis Android — это вспомогательная библиотека для Proxyman, которая позволяет захватывать и просматривать сетевой трафик ваших Android-приложений без настройки прокси или установки сертификатов.

Возможности

• Автоматическое перехватывание трафика OkHttp
• Захват сообщений WebSocket (отправка, получение, закрытие)
• Работает с Retrofit 2.9+ и Apollo Kotlin 3.x/4.x
• Сетевое обнаружение служб (NSD) для автоматического обнаружения Proxyman
• Поддержка прямого подключения для эмуляторов
• Сжатие GZIP для эффективной передачи данных
• Требуется минимальная настройка

Требования

• Android API 26+ (Android 8.0 Oreo)
• OkHttp 4.x или 5.x
• Kotlin 1.9+

Установка

Вариант 1: JitPack (рекомендуется)

Добавьте репозиторий JitPack в ваш settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        maven { url = uri("https://jitpack.io") }
    }
}

Затем добавьте зависимость в build.gradle.kts вашего модуля:

dependencies {
    debugImplementation("com.github.ProxymanApp:atlantis-android:v1.0.0")
}

Или с помощью Groovy (build.gradle):

dependencies {
    debugImplementation 'com.github.ProxymanApp:atlantis-android:v1.0.0'
}

Вариант 2: Maven Central

Добавьте зависимость в build.gradle.kts вашего модуля:

dependencies {
    debugImplementation("com.proxyman:atlantis-android:1.0.0")
}

Или с помощью Groovy (build.gradle):

dependencies {
    debugImplementation 'com.proxyman:atlantis-android:1.0.0'
}

Быстрый старт

1. Инициализация в Application

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        if (BuildConfig.DEBUG) {
            Atlantis.start(this)
        }
    }
}

2. Добавление перехватчика в OkHttpClient

val okHttpClient = OkHttpClient.Builder()
    .addInterceptor(Atlantis.getInterceptor())
    .build()

3. Захват трафика WebSocket (необязательно)

Оберните ваш WebSocketListener с помощью Atlantis.wrapWebSocketListener(), чтобы захватывать сообщения WebSocket:

val listener = Atlantis.wrapWebSocketListener(object : WebSocketListener() {
    override fun onOpen(webSocket: WebSocket, response: Response) {
        // your logic
    }
    override fun onMessage(webSocket: WebSocket, text: String) {
        // your logic
    }
    // ...
})

okHttpClient.newWebSocket(request, listener)

4. Запуск приложения

Откройте Proxyman на вашем Mac, запустите ваше Android-приложение и наблюдайте за появлением трафика!

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

atlantis-android/
├── atlantis/              # Модуль библиотеки
│   └── src/
│       ├── main/kotlin/
│       │   └── com/proxyman/atlantis/
│       │       ├── Atlantis.kt                  # Точка входа
│       │       ├── AtlantisInterceptor.kt        # Перехватчик OkHttp
│       │       ├── AtlantisWebSocketListener.kt  # Захват WebSocket
│       │       ├── Base64Utils.kt                # Кодирование Base64
│       │       ├── Configuration.kt              # Модель конфигурации
│       │       ├── GzipCompression.kt            # Сжатие
│       │       ├── Message.kt                    # Типы сообщений
│       │       ├── NsdServiceDiscovery.kt        # Обнаружение mDNS
│       │       ├── Packages.kt                   # Модели данных
│       │       └── Transporter.kt                # TCP-соединение
│       └── test/kotlin/                          # Модульные тесты
├── sample/                # Образец приложения
├── PUBLISHING.md          # Руководство по публикации
└── README.md

Настройка

Вариант 1: Открыть в Android Studio (рекомендуется)

Просто откройте папку atlantis-android в Android Studio. Она автоматически загрузит обёртку Gradle и синхронизирует проект.

Вариант 2: Генерация обёртки Gradle вручную

Если у вас локально установлен Gradle:

cd atlantis-android
gradle wrapper --gradle-version 8.7

Сборка

# Сборка библиотеки
./gradlew :atlantis:build

# Запуск тестов
./gradlew :atlantis:test

# Сборка образца приложения
./gradlew :sample:assembleDebug

Тестирование

./gradlew :atlantis:test

Публикация

Смотрите PUBLISHING.md для инструкций по публикации в Maven Central или JitPack.

Лицензия

Apache License 2.0