Atlantis Android

Capture tráfego HTTP/HTTPS de aplicativos Android e envie para o Proxyman para depuração.

Visão Geral

Atlantis Android é uma biblioteca complementar ao Proxyman que permite capturar e inspecionar o tráfego de rede dos seus aplicativos Android sem configurar um proxy ou instalar certificados.

Funcionalidades

• Interceptação automática de tráfego OkHttp
• Captura de mensagens WebSocket (envio, recebimento, fechamento)
• Funciona com Retrofit 2.9+ e Apollo Kotlin 3.x/4.x
• Descoberta de Serviço de Rede (NSD) para detecção automática do Proxyman
• Suporte a conexão direta para emuladores
• Compressão GZIP para transferência eficiente de dados
• Configuração mínima necessária

Requisitos

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

Instalação

Opção 1: JitPack (Recomendado)

Adicione o repositório JitPack ao seu settings.gradle.kts:

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

Em seguida, adicione a dependência no build.gradle.kts do seu módulo:

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

Ou com Groovy (build.gradle):

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

Opção 2: Maven Central

Adicione a dependência no build.gradle.kts do seu módulo:

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

Ou com Groovy (build.gradle):

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

Início Rápido

1. Inicializar no Application

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

2. Adicionar Interceptor ao OkHttpClient

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

3. Capturar Tráfego WebSocket (Opcional)

Envolva seu WebSocketListener com Atlantis.wrapWebSocketListener() para capturar mensagens WebSocket:

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

okHttpClient.newWebSocket(request, listener)

4. Executar Seu App

Abra o Proxyman no seu Mac, execute seu aplicativo Android e veja o tráfego aparecer!

Estrutura do Projeto

atlantis-android/
├── atlantis/              # Módulo da biblioteca
│   └── src/
│       ├── main/kotlin/
│       │   └── com/proxyman/atlantis/
│       │       ├── Atlantis.kt                  # Ponto de entrada principal
│       │       ├── AtlantisInterceptor.kt        # Interceptor OkHttp
│       │       ├── AtlantisWebSocketListener.kt  # Captura WebSocket
│       │       ├── Base64Utils.kt                # Codificação Base64
│       │       ├── Configuration.kt              # Modelo de configuração
│       │       ├── GzipCompression.kt            # Compressão
│       │       ├── Message.kt                    # Tipos de mensagens
│       │       ├── NsdServiceDiscovery.kt        # Descoberta mDNS
│       │       ├── Packages.kt                   # Modelos de dados
│       │       └── Transporter.kt                # Conexão TCP
│       └── test/kotlin/                          # Testes unitários
├── sample/                # App de exemplo
├── PUBLISHING.md          # Guia de publicação
└── README.md

Configuração

Opção 1: Abrir no Android Studio (Recomendado)

Simplesmente abra a pasta atlantis-android no Android Studio. Ele baixará automaticamente o wrapper do Gradle e sincronizará o projeto.

Opção 2: Gerar o Gradle Wrapper Manualmente

Se você tiver o Gradle instalado localmente:

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

Compilação

# Compilar a biblioteca
./gradlew :atlantis:build

# Executar testes
./gradlew :atlantis:test

# Compilar app de exemplo
./gradlew :sample:assembleDebug

Testes

./gradlew :atlantis:test

Publicação

Veja PUBLISHING.md para instruções sobre como publicar no Maven Central ou JitPack.

Licença

Apache License 2.0