Atlantis Android

Capturez le trafic HTTP/HTTPS des applications Android et envoyez-le à Proxyman pour débogage.

Aperçu

Atlantis Android est une bibliothèque compagnon de Proxyman qui vous permet de capturer et d'inspecter le trafic réseau de vos applications Android sans configurer de proxy ni installer de certificats.

Fonctionnalités

Interception automatique du trafic OkHttp
Capture des messages WebSocket (envoi, réception, fermeture)
Compatible avec Retrofit 2.9+ et Apollo Kotlin 3.x/4.x
Découverte de services réseau (NSD) pour la détection automatique de Proxyman
Prise en charge de la connexion directe pour les émulateurs
Compression GZIP pour un transfert de données efficace
Configuration minimale requise

Prérequis

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

Installation

Option 1 : JitPack (Recommandé)

Ajoutez le dépôt JitPack à votre settings.gradle.kts :

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

Ajoutez ensuite la dépendance dans le build.gradle.kts de votre module :

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

Ou avec Groovy (build.gradle) :

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

Option 2 : Maven Central

Ajoutez la dépendance dans le build.gradle.kts de votre module :

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

Ou avec Groovy (build.gradle) :

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

Démarrage rapide

1. Initialisation dans l'Application

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

2. Ajouter l'intercepteur à OkHttpClient

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

3. Capturer le trafic WebSocket (Optionnel)

Enveloppez votre WebSocketListener avec Atlantis.wrapWebSocketListener() pour capturer les messages WebSocket :

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

okHttpClient.newWebSocket(request, listener)

4. Lancer votre application

Ouvrez Proxyman sur votre Mac, lancez votre application Android, et regardez le trafic apparaître !

Structure du projet

atlantis-android/
├── atlantis/              # Module de la bibliothèque
│   └── src/
│       ├── main/kotlin/
│       │   └── com/proxyman/atlantis/
│       │       ├── Atlantis.kt                  # Point d'entrée principal
│       │       ├── AtlantisInterceptor.kt        # Intercepteur OkHttp
│       │       ├── AtlantisWebSocketListener.kt  # Capture WebSocket
│       │       ├── Base64Utils.kt                # Encodage Base64
│       │       ├── Configuration.kt              # Modèle de configuration
│       │       ├── GzipCompression.kt            # Compression
│       │       ├── Message.kt                    # Types de messages
│       │       ├── NsdServiceDiscovery.kt        # Découverte mDNS
│       │       ├── Packages.kt                   # Modèles de données
│       │       └── Transporter.kt                # Connexion TCP
│       └── test/kotlin/                          # Tests unitaires
├── sample/                # Application exemple
├── PUBLISHING.md          # Guide de publication
└── README.md

Configuration

Option 1 : Ouvrir dans Android Studio (Recommandé)

Ouvrez simplement le dossier atlantis-android dans Android Studio. Il téléchargera automatiquement le wrapper Gradle et synchronisera le projet.

Option 2 : Générer manuellement le wrapper Gradle

Si vous avez Gradle installé localement :

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

Compilation

# Compiler la bibliothèque
./gradlew :atlantis:build

# Exécuter les tests
./gradlew :atlantis:test

# Compiler l'application exemple
./gradlew :sample:assembleDebug

Tests

./gradlew :atlantis:test

Publication

Voir PUBLISHING.md pour les instructions de publication sur Maven Central ou JitPack.

Licence

Licence Apache 2.0

atlantis-android

Populaires