Atlantis Android

Erfassen Sie HTTP/HTTPS-Traffic von Android-Apps und senden Sie ihn zur Fehlersuche an Proxyman.

Übersicht

Atlantis Android ist eine Begleitbibliothek für Proxyman, mit der Sie Netzwerkverkehr von Ihren Android-Apps erfassen und untersuchen können, ohne einen Proxy konfigurieren oder Zertifikate installieren zu müssen.

Funktionen

Automatische OkHttp-Traffic-Erfassung
Erfassung von WebSocket-Nachrichten (Senden, Empfangen, Schließen)
Funktioniert mit Retrofit 2.9+ und Apollo Kotlin 3.x/4.x
Network Service Discovery (NSD) zur automatischen Proxyman-Erkennung
Unterstützung für direkte Verbindungen mit Emulatoren
GZIP-Komprimierung für effiziente Datenübertragung
Minimale Konfiguration erforderlich

Anforderungen

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

Installation

Option 1: JitPack (Empfohlen)

Fügen Sie das JitPack-Repository zu Ihrer settings.gradle.kts hinzu:

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

Fügen Sie dann die Abhängigkeit in der build.gradle.kts Ihres Moduls hinzu:

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

Oder mit Groovy (build.gradle):

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

Option 2: Maven Central

Fügen Sie die Abhängigkeit in der build.gradle.kts Ihres Moduls hinzu:

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

Oder mit Groovy (build.gradle):

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

Schnellstart

1. In der Application initialisieren

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

2. Interceptor zu OkHttpClient hinzufügen

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

3. WebSocket-Traffic erfassen (Optional)

Umgeben Sie Ihren WebSocketListener mit Atlantis.wrapWebSocketListener(), um WebSocket-Nachrichten zu erfassen:

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. Führen Sie Ihre App aus

Öffnen Sie Proxyman auf Ihrem Mac, führen Sie Ihre Android-App aus und beobachten Sie, wie der Traffic erscheint!

Projektstruktur

atlantis-android/
├── atlantis/              # Library module
│   └── src/
│       ├── main/kotlin/
│       │   └── com/proxyman/atlantis/
│       │       ├── Atlantis.kt                  # Main entry point
│       │       ├── AtlantisInterceptor.kt        # OkHttp interceptor
│       │       ├── AtlantisWebSocketListener.kt  # WebSocket capture
│       │       ├── Base64Utils.kt                # Base64 encoding
│       │       ├── Configuration.kt              # Config model
│       │       ├── GzipCompression.kt            # Compression
│       │       ├── Message.kt                    # Message types
│       │       ├── NsdServiceDiscovery.kt        # mDNS discovery
│       │       ├── Packages.kt                   # Data models
│       │       └── Transporter.kt                # TCP connection
│       └── test/kotlin/                          # Unit tests
├── sample/                # Sample app
├── PUBLISHING.md          # Publishing guide
└── README.md

Einrichtung

Option 1: In Android Studio öffnen (Empfohlen)

Öffnen Sie einfach den Ordner atlantis-android in Android Studio. Es lädt automatisch den Gradle Wrapper herunter und synchronisiert das Projekt.

Option 2: Gradle Wrapper manuell generieren

Wenn Sie Gradle lokal installiert haben:

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

Erstellen

# Build the library
./gradlew :atlantis:build

# Run tests
./gradlew :atlantis:test

# Build sample app
./gradlew :sample:assembleDebug

Testen

./gradlew :atlantis:test

Veröffentlichen

Siehe PUBLISHING.md für Anweisungen zur Veröffentlichung auf Maven Central oder JitPack.

Lizenz

Apache License 2.0

atlantis-android

Beliebteste