Giriş: Bir testçi neden uygulama ile sunucu arasına kendi proxy'sini koymalı?

Düşünün: bir mobil uygulamayı test ediyorsunuz, butona basıyorsunuz ve ekranda soyut bir hata beliriyor: "Bir şeyler ters gitti". Geliştirici soruyor: "Hangi istek gitti? Hangi yanıt geldi? Durum kodu ne?" Proxy olmadan elinizi açıp omuz silkersiniz. Proxy ile istek listesini açarsınız, sunucu yanıt gövdesini kopyalar ve otuz saniyede hataya eklersiniz. İşte "tıklayan" bir testçi ile perde arkasında ne olduğunu anlayan bir testçi arasındaki fark budur.

Bu makale bilinçli olarak normal kullanıcılar için yazılmış, telefonun Wi-Fi ayarlarına proxy adresini nasıl gireceğinizi anlatan kılavuzlardan farklıdır. Burada bir QA mühendisinin iş akışını ele alıyoruz: bilgisayarda kesici proxy, Android emülatör trafiğini ona yönlendirme, gerçek cihazı Wi-Fi ve USB üzerinden adb reverse komutuyla port yönlendirme yaparak bağlama, ayrıca test ortamı trafiğini yakalama ve değiştirme. Telefonda kullanıcı tarafında proxy ayarlamak bu sürecin sadece küçük bir tuğlasıdır.

Sonunda ne elde edeceksiniz

  • Uygulamanızın her HTTP ve HTTPS isteğini gösteren çalışan bir kesici proxy (mitmproxy veya Charles).
  • Trafiği bu proxy üzerinden geçen, şifreli trafik dahil, bir Android emülatörü.
  • Proxy'ye iki şekilde bağlanan gerçek bir akıllı telefon: Wi-Fi ile ve adb reverse ile USB kablosu üzerinden.
  • Uygulamanın sertifikaya neden "güvenmediğini" ve bunun test derlemesinde nasıl çözüleceğini anlama.
  • Backend geliştiricisi olmadan test ortamı yanıtlarını değiştirme, yavaş ağ ve sunucu hatalarını simüle etme becerisi.

Bu kılavuz kimler için

Mobil uygulamaları manuel ve otomatik test eden, ağ trafiğini tahmin etmek yerine görmek isteyen testçiler için. Yeni işe başladığında kendisine "Charles'a bir bak" denilen ama bunun ne olduğu ve nasıl yapıldığı anlatılmayan junior'lar için. Ekibe test ortamı kuran geliştiriciler için.

Önceden bilmeniz gerekenler

HTTP isteği, yanıtı, 200 ve 500 durum kodunun ne olduğuna dair temel bilgi. Terminal veya komut satırını açıp komut çalıştırma becerisi. Android'e uygulama yükleme deneyimi. Emülatörü hiç başlatmadıysanız sorun değil, bu yolu birlikte geçeceğiz.

Ne kadar zaman alacak

İyi bir internet ve kurulu bir Android Studio ile tüm kılavuz bir buçuk ila iki saat sürer. Android Studio henüz yoksa sistem imajlarını indirmek için 30-60 dakika ekleyin. İlk geçişten sonra yeni bir projede yeniden kurulum yaklaşık on dakika alır.

Ön hazırlık: araçlar, erişimler ve sistem gereksinimleri

Bilgisayara kurmanız gerekenler

  1. Android Studio'nun 2025-2026 güncel sürümü. Bununla birlikte Android SDK, Android Emulator ve adb aracı kurulur. Temel araç seti budur.
  2. Kesici proxy. Kılavuzda iki seçenek gösteriliyor: ücretsiz mitmproxy (terminalde ve mitmweb web arayüzüyle çalışır) ve ücretsiz deneme modu olan ticari Charles Proxy. Birini seçin, diğerini sonra öğrenebilirsiniz. Tüm talimatlar her ikisi için de verilmiştir.
  3. Java ayrıca gerekli değil: Android Studio dahili JDK kullanır.
  4. Uygulamanın test derlemesi APK formatında. Bu, mağazadan gelen sürüm değil, debug derlemesi veya özel bir QA derlemesi olmalıdır. Bunun neden kritik olduğunu sertifikalar bölümünde açıklayacağız.

Sistem gereksinimleri

  • İşletim sistemi: Windows 10 veya 11 (64-bit), macOS 12 ve üzeri, KVM destekli Linux.
  • RAM: en az 8 GB, rahat çalışma için 16 GB. Emülatör tek başına 2-4 GB yer.
  • Boş disk alanı: en az 20 GB. Bir Android sistem imajı 1,5-2 GB ağırlığındadır, artı Android Studio'nun kendisi.
  • BIOS/UEFI'de donanım sanallaştırması açık olmalı (Intel VT-x veya AMD-V). Bu olmadan emülatör ya çok yavaş çalışır ya da hiç başlamaz.
  • Android 8 ve üzeri sürümlü, veri aktarımı için (sadece şarj değil) USB kablosu olan gerçek bir Android cihaz.

Ekipten talep etmeniz gereken erişimler

  • Test ortamı adresi (örneğin, https://api-stage.example-team.ru) ve test kimlik bilgileri.
  • Uygulamanın debug derlemesi veya "QA build" bayraklı derlemesi. Geliştiricilere, kullanıcı sertifikalarına güvenip güvenmediğini ve certificate pinning'in devre dışı olup olmadığını sorun.
  • Ortam IP ile korunuyorsa veya kurumsal ağa bağlanmanız gerekiyorsa — yöneticiye iş bilgisayarınızdan nasıl bağlanacağınızı sorun. Kısıtlamaları aşma yollarını ele almıyoruz: sadece ekibinizin verdiği resmi erişimler.

Yedekler ve güvenlik

Emülatördeki ve cihazdaki proxy ayarları tamamen geri alınabilir. Ancak başlamadan önce iki şey yapmalısınız. Birincisi, gerçek telefonda zaten çalışan Wi-Fi ayarları veya sertifikalar varsa, ayar ekranlarının ekran görüntülerini alın — böylece her şeyi hızla eski haline döndürebilirsiniz. İkincisi, bankacılık uygulamaları olan kişisel telefon yerine ayrı bir test cihazı kullanmak daha iyidir: proxy'nin kök sertifikası sahibine şifreli trafiği okuma imkanı verir. Test cihazında bu normaldir, kişisel cihazda risklidir.

Dikkat: Bankacılık ve ödeme uygulamaları olan kişisel bir cihaza asla kesici proxy'nin kök sertifikasını yüklemeyin ve proxy'nin özel anahtar dosyasını mesajlaşma uygulamaları üzerinden meslektaşlarınıza göndermeyin. Sertifika yerel olarak bilgisayarınızda oluşturulur ve orada kalmalıdır.

Temel kavramlar: trafik yakalama nasıl çalışır

Kesici proxy nedir

Normal bir proxy, istemciden gelen isteği alıp sunucuya ileten bir aracıdır. Kesici proxy (hata ayıklama veya man-in-the-middle proxy'si de denir) aynı şeyi yapar, ancak her isteğin ve yanıtın bir kopyasını saklar, size uygun bir biçimde gösterir ve bunları durdurmanıza, değiştirmenize ve değiştirmenize olanak tanır. Bir testçi için bu, bir doktor için röntgen gibidir.

HTTPS neden öylece görünmez

Modern trafiğin neredeyse tamamı TLS protokolüyle şifrelenir. Proxy, telefonun api-stage.example-team.ru sunucusuna bağlandığını görür, ancak istek içerikleri onun için şifreli bir akıştır. Şifreyi çözmek için proxy kendi kök sertifikasını (CA) oluşturur ve her site için anında sahte sertifikalar üretir. Telefonun bu kök sertifikaya güvenmesi gerekir — aksi halde uygulama değişikliği fark eder ve "Trust anchor for certification path not found" gibi bir hatayla bağlantıyı keser. Bu nedenle proxy sertifikasını cihaza yüklemek zorunlu bir adımdır.

Android'de kullanıcı ve sistem sertifikaları

Android 7'den itibaren uygulamalar varsayılan olarak yalnızca sistem sertifikalarına güvenir ve kullanıcının ayarlar üzerinden yüklediği sertifikaları yok sayar. Chrome tarayıcısı bir istisnadır, kullanıcı sertifikalarına güvenir. Uygulamanızın proxy sertifikasına güvenmesi için geliştiricilerin iki yasal yolu vardır: ya debug derlemesinde kullanıcı sertifikalarına güvenmeye izin veren network_security_config.xml dosyasını eklerler, ya da root yetkili bir emülatörde sertifikayı sistem sertifikası olarak yüklersiniz. İlk yol daha basit ve ekip çalışması için daha doğrudur.

Certificate pinning

Bazı uygulamalar ek olarak sunucunun belirli bir sertifikasını "sabitler" ve başka bir sertifikayla, güvenilir olsa bile, çalışmayı reddeder. Bu üretimde iyi bir korumadır, ancak test ortamında pinning genellikle debug derlemelerinde devre dışı bırakılır. Tüm ayarlardan sonra uygulama hâlâ proxy üzerinden gitmiyorsa, geliştiricilere özellikle pinning'i sorun.

Emülatör bilgisayarınızı nasıl görür

Android emülatörü kendi ağı olan bir sanal makinedir. İçinde 127.0.0.1 adresi emülatörün kendisini, bilgisayarınızı değil. Bilgisayara erişmek için emülatörden özel 10.0.2.2 adresi kullanılır. Bunu unutmayın — aşağıdaki komutlarda karşınıza çıkacak.

adb ve adb reverse nedir

adb (Android Debug Bridge), Android cihazı bilgisayardan yöneten bir konsol aracıdır: uygulama yükler, komut çalıştırır, portları yönlendirir. adb reverse komutu, cihazdaki bir portun bilgisayarınızdaki bir porta "baktığı" bir durum yaratır. Örneğin, adb reverse tcp:8080 tcp:8080 komutundan sonra telefondaki uygulama localhost:8080 adresine başvurduğunda aslında proxy'nin dinlediği bilgisayarın 8080 portuna ulaşır. Bu USB üzerinden çalışır, ortak Wi-Fi ağı gerektirmez ve erişim noktasının kurumsal kısıtlamalarından etkilenmez. Ters komut olan adb forward diğer yönde çalışır: bilgisayarın portu cihaza yönlendirir. Bunları karıştırmayın.

Test ortamı

Ortam (stage, staging, dev ortamı) uygulamanın sunucu tarafının test için bir kopyasıdır. Ortamda verileri bozabilir, yanıtları değiştirebilir ve logları görebilirsiniz. Uygulama genellikle ayrı bir derleme veya gizli bir menü aracılığıyla ortama geçer. Tüm trafik yakalamayı üretimle değil, ortamla yapıyoruz.

Adım 1: Bilgisayarda kesici proxy'yi ayağa kaldırıyoruz

Bu aşamanın amacı: bilgisayarda bir proxy çalışıyor, bir portu dinliyor (mitmproxy için 8080 veya Charles için 8888) ve bilgisayarın yerel ağdaki IP adresini biliyorsunuz.

Seçenek A: mitmproxy

  1. İşletim sisteminiz için mitmproxy kurulum dosyasını projenin resmi sitesinden indirin veya paket yöneticisiyle kurun. macOS'ta Homebrew ile, Windows'ta .msi formatındaki kurulum dosyasıyla, Linux'ta pipx veya ikili arşivle kolayca kurulur.
  2. Terminali açın (Windows'ta PowerShell veya Windows Terminal).
  3. Web sürümünü şu komutla başlatın:
    mitmweb --listen-port 8080
    Terminalde proxy'nin 8080 portunda başladığına dair satırlar belirir ve tarayıcıda 127.0.0.1:8081 adresinde web arayüzü sekmesi açılır. İstekler tam da burada görünecek.
  4. Dikkat: mitmweb arayüzü 8081 portunda çalışır, ancak proxy'nin kendisi 8080'i dinler. Cihaz ayarlarında her zaman 8080 belirtin.
  5. İlk çalıştırmada mitmproxy, kullanıcının ev dizininde .mitmproxy klasörünü oluşturur. İçinde mitmproxy-ca-cert.cer dosyası bulunur — bu, cihazlara daha sonra yükleyeceğimiz kök sertifikadır.

İpucu: Tarayıcı olmadan tamamen terminalde çalışmak isterseniz, mitmweb yerine mitmproxy komutunu çalıştırın. Arayüz konsol tabanlı olacaktır: gezinmek için ok tuşları, isteği açmak için Enter, geri dönmek için q. Otomasyon için akışı dosyaya yazan mitmdump mevcuttur.

Seçenek B: Charles Proxy

  1. Charles'ı resmi sitesinden indirin, kurun ve çalıştırın. Solda boş bir liste, sağda Overview, Contents sekmeleri olan ana pencere açılır.
  2. Proxy → Proxy Settings menüsünü açın. Proxies sekmesinde portun 8888 olduğundan ve "Enable transparent HTTP proxying" onay kutusunun kapalı olduğundan emin olun. OK'e basın.
  3. Proxy → SSL Proxying Settings menüsünü açın. Enable SSL Proxying onay kutusunu işaretleyin. Include bloğunda Add'e tıklayın ve * ana makinesini 443 portuyla ekleyin. Böylece Charles tüm HTTPS'i çözecek. Daha sonra listeyi ortam alan adıyla daraltabilirsiniz.
  4. Charles macOS veya Windows sistem proxy'sini ayarlamayı teklif ederse reddedin: bize telefonun trafiği gerekiyor, bilgisayarın tarayıcısının değil. Proxy menüsünden macOS Proxy veya Windows Proxy onay kutularını kaldırarak devre dışı bırakabilirsiniz.

Bilgisayarın IP adresini öğreniyoruz

Wi-Fi üzerinden gerçek cihaz için bilgisayarın yerel ağdaki adresi gerekli olacak.

  1. Windows: PowerShell'de ipconfig çalıştırın ve etkin Wi-Fi veya Ethernet adaptörünün IPv4 adresi satırını bulun. Genellikle 192.168.1.45 gibi bir şeydir.
  2. macOS: Sistem Ayarları → Ağ → etkin bağlantıyı seçin, adres ayrıntılarda gösterilir. Veya terminalde ipconfig getifaddr en0.
  3. Linux: ip addr show veya hostname -I komutu.

Bu adresi not edin. Metin boyunca buna koşullu olarak 192.168.1.45 diyeceğiz, kendinizinkini yerleştirin.

Güvenlik duvarında portu açıyoruz

Windows, mitmproxy veya Charles'ı ilk çalıştırdığınızda programın bağlantı kabul etmesine izin verilip verilmeyeceğini sorar. Özel ağlar için mutlaka izin verin. Pencere çıkmadıysa, "Windows Defender Güvenlik Duvarı → Uygulamaya izin ver" bölümünü açın ve programı manuel olarak ekleyin. macOS'ta izin ilk gelen bağlantıda benzer şekilde istenir.

Kontrol: Bilgisayarda tarayıcıyı açın, ayarlarında geçici olarak 127.0.0.1 proxy'sini ve 8080 (veya 8888) portunu belirtin ve herhangi bir siteye gidin. mitmweb veya Charles'ta istek satırları görünmelidir. Kontrolden sonra tarayıcıdan proxy'yi kaldırın ki engellemesin. Tarayıcı ayarlamadan alternatif — komut:

curl -x http://127.0.0.1:8080 -k https://example.com
Proxy arayüzünde example.com satırı göründüyse proxy çalışıyor demektir.

Bu aşamada olası sorunlar

  • Port meşgul. "Address already in use" gibi bir mesaj. Yani 8080'de zaten bir şey dinliyor — genellikle yerel bir ortam veya başka bir araç. Proxy'yi farklı bir portta başlatın, örneğin 8082 ve bundan sonra her yerde onu kullanın.
  • mitmweb tarayıcıyı açmıyor. 127.0.0.1:8081 adresini manuel açın. Terminalde belirteçli adres yazdırılacak, tamamını kopyalayın.
  • Charles HTTPS içeriğini göstermiyor, sadece CONNECT başlıkları. SSL Proxying açık değil veya Include'a ana makine eklenmemiş. Seçenek B'nin 3. maddesine dönün.

Adım 2: Android emülatörün trafiğini proxy üzerinden yönlendiriyoruz

Bu aşamanın amacı: çalışan emülatör tüm HTTP ve HTTPS isteklerini proxy'nize gönderiyor ve siz bunları arayüzde görüyorsunuz.

Emülatör oluşturup başlatıyoruz

  1. Android Studio'yu açın. Açık bir proje yoksa başlangıç ekranında More Actions → Virtual Device Manager'ı seçin. Proje içindeyken: menü Tools → Device Manager.
  2. Cihaz oluşturma düğmesine (artı veya Create Virtual Device) basın.
  3. Bir model seçin, örneğin Pixel 8 ve Next'e basın.
  4. Sistem imajını seçin. Önemli: proxy üzerinden test için Google Play değil, Google APIs etiketli imaj daha uygundur. Google Play imajlarında root erişimi kilitlidir ve gerekirse sistem sertifikası yükleyemezsiniz. Android 14-16 için bu tür imajlar "Android 15.0 Google APIs x86_64" gibi adlandırılır (Apple işlemcili bilgisayarlarda arm64-v8a). İmajın yanında indirme oku varsa indirin, bu 5-15 dakika sürecek.
  5. Son ekranda cihaza boşluksuz bir ad verin, örneğin Pixel_8_QA ve Finish'e basın.
  6. Emülatörü üçgen simgeli düğmeyle başlatın. İlk başlatma 1-3 dakika sürer.

Yöntem 1: Emülatör panelinden ayar (en kolay)

  1. Çalışan emülatör penceresinde sağdaki dikey paneli bulun. Alttaki üç noktaya basın — Extended Controls penceresi açılır.
  2. Sol menüden Settings'i, ardından Proxy sekmesini seçin.
  3. "Use Android Studio HTTP proxy settings" onay kutusunu kaldırın.
  4. Manual proxy configuration'ı seçin.
  5. Host name alanına 127.0.0.1 yazın. Burada, Android'in kendi ayarlarından farklı olarak emülatör proxy'yi ana makine düzeyinde uygular, bu yüzden bilgisayarın adresi 127.0.0.1 olarak belirtilir.
  6. Port number alanına 8080 (Charles için 8888) yazın.
  7. Apply'e basın. Altında "Proxy status: Success" durumu görünmelidir. Error yazıyorsa proxy çalışmıyor veya yanlış port belirtilmiş.

Yöntem 2: adb üzerinden ayar (esnek, scriptler için uygun)

  1. Terminali açın. adb'nin erişilebilir olduğundan emin olun: adb devices komutu emulator-5554 device gibi bir satır göstermelidir. Komut bulunamazsa, Android SDK içindeki platform-tools klasörünü PATH'e ekleyin (yolu Android Studio'da görebilirsiniz: Settings → Languages and Frameworks → Android SDK).
  2. Şunu çalıştırın:
    adb shell settings put global http_proxy 10.0.2.2:8080
    Burada zaten Android'in "içindeyiz", bu yüzden bilgisayar 10.0.2.2 adresiyle gösterilir.
  3. Ayarın uygulandığını kontrol edin:
    adb shell settings get global http_proxy
    10.0.2.2:8080 dönmelidir.
  4. Proxy'yi kapatmak için şunu çalıştırın:
    adb shell settings put global http_proxy :0

Yöntem 3: Başlatma sırasında komut satırı parametresi

Emülatörü terminalden başlatıyorsanız (örneğin CI veya scriptlerde), şu bayrağı ekleyin:

emulator -avd Pixel_8_QA -http-proxy http://127.0.0.1:8080

emulator çalıştırılabilir dosyası, Android SDK içindeki emulator klasöründe bulunur. Proxy emülatör oturumunun tamamına uygulanır.

İpucu: İki küçük script yapın — proxy_on ve proxy_off — Yöntem 2'deki adb komutlarıyla. Bir test gününde proxy'yi onlarca kez açıp kapatacaksınız ve menüde fazladan tıklamalar yorucu olur.

Trafik gittiğini kontrol ediyoruz

  1. Emülatörde Chrome tarayıcısını açın ve HTTPS üzerinden herhangi bir siteye gidin.
  2. mitmweb veya Charles'ta istekler görünmelidir. Muhtemelen Chrome sayfası bir güvenlik hatası gösterecek — bu normal, sertifikayı henüz yüklemedik. Önemli olan isteklerin ana makine ve CONNECT yöntemiyle kayıt olarak görünmesi.

Kontrol: Proxy arayüzünde emülatörde açtığınız sitenin alan adıyla satırlar görünüyor ve adb shell settings get global http_proxy komutu proxy'nizin adresini ve portunu döndürüyor. Her iki koşul da sağlanıyorsa emülatör doğru şekilde proxy'ye yönlendirilmiştir.

Olası sorunlar

  • Emülatör panelinde Proxy status: Error. Proxy çalışmıyor veya port farklı. mitmweb veya Charles'ı başlatın ve Apply'e tekrar basın.
  • Durum Success olmasına rağmen istekler görünmüyor. Uygulama sistem proxy'sini yok sayan kendi ağ yığınını kullanıyor olabilir (örneğin Flutter uygulamaları varsayılan olarak). Bu konu tipik hatalar bölümünde.
  • Emülatör proxy kapatıldıktan sonra interneti kaybetti. Muhtemelen http_proxy değerini ":0" yerine boş bıraktınız. Kapatma komutunu iki nokta ve sıfırla tekrarlayın ve emülatörü yeniden başlatın.

Adım 3: Proxy sertifikasını yüklüyoruz ve güven sorununu çözüyoruz

Bu aşamanın amacı: emülatör ve test uygulaması proxy'nin kök sertifikasına güveniyor ve HTTPS isteklerinin çözülmüş içeriğini görüyorsunuz: URL, başlıklar, istek ve yanıt gövdeleri.

Sertifikayı kullanıcı sertifikası olarak yüklüyoruz

  1. Emülatörde proxy'nin açık olduğundan emin olun (Adım 2).
  2. Emülatör içindeki Chrome tarayıcısında mitm.it (mitmproxy için) veya chls.pro/ssl (Charles için) adresini açın. Bunlar, proxy'nin yakalayıp sertifika indirme sayfasını döndürdüğü özel adreslerdir. Sayfa yerine normal bir site veya hata görüyorsanız trafik proxy üzerinden gitmiyor, Adım 2'ye dönün.
  3. mitmproxy için Android düğmesine basın ve mitmproxy-ca-cert.cer dosyasını indirin. Charles için dosya hemen indirilir.
  4. Emülatörde Ayarlar → Güvenlik ve gizlilik → Diğer güvenlik ayarları → Şifreleme ve kimlik bilgileri → Sertifika yükle → CA sertifikası'nı açın (bazı sürümlerde yol: Güvenlik → Gelişmiş ayarlar → Şifreleme ve kimlik bilgileri). Riskler hakkında bir uyarı görünecek — "Yine de yükle"ye basın.
  5. İndirilen dosyayı Downloads klasöründe seçin. Emülatör ekran PIN'i isterse basit bir tane belirleyin, örneğin 1234 ve unutmayın.
  6. Yüklemeden sonra kontrol edin: Şifreleme ve kimlik bilgileri → Güvenilen sertifikalar → Kullanıcı sekmesi. Orada mitmproxy veya Charles Proxy CA kaydı görünmelidir.

Tarayıcı olmadan alternatif yöntem — dosyayı adb push komutuyla kopyalayıp sonra dosya yöneticisinden seçmek:

adb push ~/.mitmproxy/mitmproxy-ca-cert.cer /sdcard/Download/

Artık emülatördeki Chrome herhangi bir HTTPS sitesini hatasız açacak ve proxy'de tarayıcının çözülmüş isteklerini göreceksiniz. Ancak test uygulamanız muhtemelen hâlâ ağ hatasıyla çökecek. Asıl konuya geçiyoruz.

Uygulama neden güvenmiyor ve geliştiricilerden ne istemeli

Temel kavramlarda ele aldığımız gibi, Android 7+ uygulamaları kullanıcı sertifikalarını yok sayar. Doğru çözüm, debug derlemesinin ağ güvenliği yapılandırma dosyasını içermesidir. Geliştirici res/xml/network_security_config.xml dosyasına yaklaşık şu içeriği ekler:

<network-security-config><debug-overrides><trust-anchors><certificates src='system' /><certificates src='user' /></trust-anchors></debug-overrides></network-security-config>

Ve bunu AndroidManifest.xml'de android:networkSecurityConfig özniteliği aracılığıyla bağlar. debug-overrides bloğu yalnızca hata ayıklama derlemelerinde çalışır, bu yüzden sürüm korumalı kalır. Bu standart bir uygulamadır ve çoğu ekipte böyle bir dosya zaten vardır. Yoksa yukarıdaki parçayı geliştirici görevine kopyalayın.

Dikkat: Geliştiriciden debug-overrides olmadan temel yapılandırmaya kullanıcı sertifikalarına güven eklemesini istemeyin ve sürümde sertifika doğrulamasının kapatılmasına razı olmayın. Bu, gerçek kullanıcıların güvenliğini zayıflatır. Tüm değişiklikler yalnızca debug ve QA derlemelerini etkilemelidir.

Yedek yol: root'lu emülatörde sistem sertifikası

Derleme sizin için değiştirilemiyorsa, Google APIs imajlı (Google Play değil) emülatörde sertifika sistem deposuna konabilir. Böylece pinning olmayan herhangi bir uygulama ona güvenir. Android 14 ve üzeri için kısa işlem sırası, sistem sertifikaları apex bölümünde olduğundan:

  1. Emülatörü terminalden -writable-system bayrağıyla başlatın.
  2. adb root, ardından adb remount çalıştırın.
  3. Sertifika dosyasının adını hash formatında openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.cer -noout komutuyla hesaplayın ve dosyayı elde edilen değere .0 sonekiyle yeniden adlandırın (örneğin, c8750f0d.0).
  4. Dosyayı adb push ile /system/etc/security/cacerts/ içindeki sistem sertifika deposuna kopyalayın ve emülatörü yeniden başlatın. Android 14+ için ayrıca sistemin sertifikaları yüklediği dizini yeniden bağlamak gerekir; mitmproxy belgelerinde bunun için hazır bir script vardır.

Bu yol daha güçlü ama daha kırılgandır: imaj güncellendikten sonra her şey sıfırlanır ve Android 14+ için adımlar daha karmaşıktır. Günlük iş için network_security_config'li ilk yolu öneriyoruz.

Test uygulamasını yüklüyoruz

  1. APK'yı uygun bir klasöre koyun.
  2. adb install -r yol/app-debug.apk komutunu çalıştırın. -r bayrağı mevcut sürümün üzerine verileri koruyarak yeniden yükler.
  3. 10-30 saniye sonra Success görünecek ve uygulama simgesi emülatörde belirecek.

Kontrol: Test uygulamasını açın, ortamda oturum açın. mitmweb veya Charles'ta ortam alan adına istekler göründü ve herhangi birine tıkladığınızda başlıklar, JSON istek gövdesi ve yanıt gövdesi sekmelerini görüyorsunuz. Yanıt gövdesi okunabiliyorsa sertifika yüklendi ve uygulama ona güveniyor. Bu, tüm kılavuzun ana kontrol noktasıdır.

Olası sorunlar

  • Chrome siteleri açıyor ama uygulama ağ hatası gösteriyor. Uygulama kullanıcı sertifikasına güvenmiyor. network_security_config'li bir derleme veya sistem sertifikası gerekir.
  • Uygulama günlüklerinde (adb logcat) "Certificate pinning failure" görünüyor. Pinning açık. Ortam alan adı için pinning kapatılmış bir QA derlemesi isteyin.
  • mitm.it "If you can see this, traffic is not passing through mitmproxy" sayfası gösteriyor. Proxy uygulanmadı. Adım 2'nin ayarını kontrol edin.

Adım 4: Gerçek cihazı Wi-Fi üzerinden bağlıyoruz

Bu aşamanın amacı: bilgisayarla aynı Wi-Fi ağındaki gerçek akıllı telefon trafiği proxy'ye gönderiyor.

Bu, normal kullanıcı kılavuzlarında anlatılan yöntemdir, ancak bir testçinin kendine özgü nüansları vardır: ne zaman işe yaramayacağını anlamak ve hızla geçiş yapabilmek gerekir. Emülatör gerçek cihazın yerini tutmaz: gerçek kamerası yoktur, push bildirimleri farklı gelir, sensörler ve güç tasarrufu farklı davranır. Bu yüzden ağ senaryolarını gerçek telefonda test etmek zorunludur.

Wi-Fi parametrelerinde proxy'yi ayarlıyoruz

  1. Telefonu bilgisayarla aynı Wi-Fi ağına bağlayın. Ev yönlendiricisi uygundur. Misafir kurumsal ağ — genellikle hayır, bu konu aşağıda.
  2. Ayarlar → Ağ ve internet → Wi-Fi'yi açın (Samsung'da: Bağlantılar → Wi-Fi).
  3. Mevcut ağın yanındaki dişliye basın veya ağ adına uzun basarak menüyü çağırın ve "Ağı değiştir"i seçin.
  4. "Gelişmiş" veya "Gelişmiş ayarlar"ı genişletin.
  5. Proxy maddesinde Manuel'i seçin.
  6. Proxy ana makinesi: bilgisayarınızın IP adresi, örneğin 192.168.1.45. Port: 8080 veya 8888. "Proxy kullanma" alanını boş bırakın.
  7. Kaydedin. Telefon ağa yeniden bağlanacak.

Telefona sertifika yüklüyoruz

  1. Telefonda Chrome'u açın ve mitm.it veya chls.pro/ssl adresine gidin. Sertifikayı indirin.
  2. Ayarlar → Güvenlik → Şifreleme ve kimlik bilgileri → Sertifika yükle → CA sertifikası → dosyayı seçin. Madde adları Samsung, Xiaomi, Huawei'de biraz farklıdır, ancak mantık aynıdır: "kimlik bilgileri" veya "sertifika" kelimelerini arayın.
  3. Test uygulamasını adb install veya doğrudan dosyadan yükleyin.

İpucu: Yönlendirici ayarlarında bilgisayara kalıcı bir IP adresi atayın (MAC adresine göre DHCP rezervasyonu). Aksi halde yönlendirici yeniden başladıktan sonra adres değişir ve ekipteki tüm telefonlar proxy üzerinden gitmeyi bırakır, siz de yarım saat sebebini ararsınız.

Wi-Fi yöntemi ne zaman çalışmaz

  • Kurumsal veya misafir ağda istemci izolasyonu (AP isolation). Cihazlar interneti görür ama birbirlerini görmezler. Belirti: proxy'li telefon tamamen interneti kaybeder ve mitm.it açılmaz. Kontrol: bilgisayardan telefonun IP adresine ping atın (Wi-Fi özelliklerinden görebilirsiniz). Yanıt yoksa izolasyon var demektir.
  • Bilgisayar ve telefon farklı alt ağlarda. Örneğin, dizüstü bilgisayar kablolu 10.10.0.x ağında, telefon Wi-Fi 192.168.1.x'te.
  • Bilgisayarın güvenlik duvarı gelen bağlantıları engelliyor. Özellikle Windows'ta "Ortak" ağla sık karşılaşılan bir sorun. Ağ profilini "Özel"e geçirin.

Tüm bu durumlarda çözüm tek: geçeceğimiz USB üzerinden port yönlendirme.

Kontrol: Proxy arayüzünde telefondan istekler göründü ve Charles'ta Client sütununda 127.0.0.1'den farklı telefonun IP'si görünüyor. Test uygulamasını açın, herhangi bir eylem yapın — ortama karşılık gelen istek çözülmüş gövdeyle listede göründü.

Adım 5: adb reverse ile port yönlendirme — Wi-Fi'siz USB üzerinden proxy

Bu aşamanın amacı: sadece USB kablosuyla bağlı gerçek telefon, Wi-Fi ağından bağımsız olarak trafiği bilgisayardaki proxy'ye yönlendiriyor.

Ofis, ortak çalışma alanı ve yönlendiriciyi yönetmediğiniz herhangi bir ağ için en güvenilir yöntemdir. Fikir: adb reverse komutuyla telefondaki 8080 portunun bilgisayarın 8080 portuna yönlendirilmesini sağlıyoruz. Sonra telefona 127.0.0.1:8080 proxy'sini kullanmasını söylüyoruz — yani "kendisi" — ve adb fark ettirmeden paketleri bilgisayara ulaştırıyor.

USB hata ayıklamayı açıyoruz

  1. Telefonda Ayarlar → Telefon hakkında'yı açın ve "Yapı numarası"na yedi kez basın. "Artık bir geliştiricisiniz" mesajı çıkacak. Xiaomi'de "MIUI sürümü" veya "HyperOS sürümü"ne basmanız gerekir.
  2. Ayarlar → Sistem → Geliştiriciler için'e dönün (Samsung'da Ayarlar'ın kökünde). USB hata ayıklama anahtarını açın.
  3. Telefonu kabloyla bilgisayara bağlayın. Telefonda "USB hata ayıklamaya izin ver?" isteği bilgisayarın parmak iziyle görünecek. "Her zaman izin ver" onay kutusunu işaretleyin ve İzin ver'e basın.
  4. Bilgisayarda adb devices komutunu çalıştırın. Seri numaralı ve device kelimeli bir satır görünmelidir. unauthorized yazıyorsa — telefon ekranına bakın, orada bir istek var. offline ise — kabloyu yeniden bağlayın.

Dikkat: Veri aktarımını destekleyen bir kablo kullanın. Harici akü setlerinden çıkan birçok ucuz kablo yalnızca şarj eder. Telefon şarj oluyor ama adb devices boşsa — ilk iş kabloyu değiştirin, sürücüleri yeniden yüklemeyin.

Yönlendirmeyi yapıyoruz

  1. Bilgisayardaki proxy'nin çalıştığından ve 8080 portunu dinlediğinden emin olun.
  2. Şu komutu çalıştırın:
    adb reverse tcp:8080 tcp:8080
    İlk sayı telefondaki port, ikincisi bilgisayardaki port. Yanıt olarak komut 8080 yazdıracak veya hiçbir şey — bu normaldir.
  3. Aktif yönlendirmelerin listesini kontrol edin:
    adb reverse --list
    host-numarası tcp:8080 tcp:8080 gibi bir satır görünmelidir.
  4. Birden fazla cihaz bağlıysa (örneğin emülatör ve telefon), -s bayrağıyla seri numarasını belirtin:
    adb -s R58M1234ABC reverse tcp:8080 tcp:8080

Telefona proxy'yi localhost olarak gösteriyoruz

Burada iki yol var. Birincisi — adb üzerinden, en hızlısı:

adb shell settings put global http_proxy 127.0.0.1:8080

İkincisi — Adım 4'teki gibi telefonun Wi-Fi ayarlarından manuel olarak, ancak ana makine alanına 127.0.0.1 ve port 8080 yazın. İkinci yol, adb üzerinden global ayarın tüm uygulamalara uygulanmadığı bazı yazılımlarda gereklidir.

Önemli bir nüansa dikkat edin. Global http_proxy ayarı sistem tarafından mevcut ağ bağlantısına uygulanır. Wi-Fi kapalıysa ve telefon mobil veri üzerinden çalışıyorsa, bazı yazılımlar bunu yine de uygular, bazıları uygulamaz. En güvenilir yol Wi-Fi'yi açık tutmak (bilgisayara çıkışı olmayan herhangi bir ağ bile) ve ayarlarında 127.0.0.1 proxy'sini belirtmektir. adb reverse üzerinden trafik, telefonun hangi Wi-Fi ağına bağlı olduğundan bağımsız olarak USB üzerinden gider.

Sertifikayı yüklüyoruz

Sıra öncekiyle aynı: Chrome → mitm.it → indir → CA sertifikası olarak yükle. Sertifika bu telefona Adım 4'te zaten yüklendiyse tekrarlamaya gerek yok.

İş sonrası yönlendirmeyi kapatıyoruz

  1. Proxy'yi kaldırın: adb shell settings put global http_proxy :0 (veya Wi-Fi ayarlarında "Yok").
  2. Yönlendirmeyi kaldırın: adb reverse --remove tcp:8080 veya hepsini birden: adb reverse --remove-all.
  3. Kablo çıkarıldığında yönlendirmelerin otomatik olarak sıfırlandığını, ancak telefondaki proxy ayarının kaldığını unutmayın. Kaldırmayı unutursanız, kablo olmadan telefon internetsiz kalır. Yeni başlayanların en sık şikayeti tam olarak böyle görünür: "telefon hiçbir şey yüklemiyor".

İpucu: Kendinize üç satırlık bir kopya kağıdı yazın: adb reverse tcp:8080 tcp:8080, adb shell settings put global http_proxy 127.0.0.1:8080, adb shell settings put global http_proxy :0. Gerçek cihazla çalışma durumlarının yüzde 90'ı için bu üç komut yeterlidir.

Kontrol: Bilgisayarda Wi-Fi'yi kapatın veya telefonu bilgisayarın erişemediği bir ağda kullanın. adb reverse çalıştırın, 127.0.0.1:8080 proxy'sini ayarlayın, telefonda Chrome'da mitm.it açın. Sertifika indirme sayfası açıldı — yönlendirme çalışıyor. Ardından test uygulamasını açın ve isteklerinin proxy'de göründüğünden emin olun.

Olası sorunlar

  • adb reverse "error: closed" veya "more than one device" veriyor. Birden fazla cihaz bağlı; -s seri_numarası belirtin. Veya cihaz offline'a geçti — kabloyu yeniden bağlayın.
  • Yönlendirme var ama mitm.it açılmıyor. Bilgisayardaki proxy'nin tam olarak 127.0.0.1'de veya tüm arayüzlerde dinlediğinden emin olun, sadece harici IP'de değil. mitmproxy varsayılan olarak tüm arayüzlerde. Charles da öyle.
  • Kablo yeniden bağlandıktan sonra trafik kayboldu. adb reverse her yeniden bağlanmada sıfırlanır. Komutu tekrar çalıştırın. Telefondaki proxy ayarı bu sırada korunur.

Adım 6: Test ortamı trafiğini yakalıyor ve değiştiriyoruz

Bu aşamanın amacı: ortama yapılan istekleri filtrelemeyi, istek ve yanıt gövdelerini okumayı, bir isteği duraklatıp sunucu yanıtını değiştirmeyi, hataları ve yavaş ağı simüle etmeyi, ayrıca adb reverse ile uygulamayı yerel bir backend'e yönlendirmeyi biliyorsunuz.

Sadece gerekli olanı filtreliyoruz

Uygulama onlarca arka plan isteği gönderir: analitik, yapılandırma güncellemesi, sürüm kontrolü. Boğulmamak için ortam alan adına göre filtre ayarlayın.

  1. mitmweb'de üstteki filtre alanına ~d api-stage.example-team.ru gibi bir ifade girin — sadece bu alan adına yapılan istekler kalır. ~u /orders ifadesi URL parçasına göre filtreler, ~c 500 sadece 500 kodlu yanıtları gösterir, ~m POST ise sadece POST istekleri. İfadeler boşlukla birleştirilebilir.
  2. Charles'ta Focus modunu açın: ortam ana makinesine sağ tıklayın → Focus. Diğer ana makineler Other Hosts grubuna katlanır. Ek olarak alt Filter alanına URL parçası girilebilir.

İsteği ve yanıtı hataya ekleyecek şekilde okuyoruz

  1. İstek satırına tıklayın. mitmweb'de sağda Request, Response, Detail sekmeleri görünecek. Charles'ta — Overview, Contents, Summary sekmeleri ve altta Headers, JSON Text, Raw geçişleri.
  2. URL'yi, yöntemi, yanıt kodunu ve JSON yanıt gövdesini kopyalayın. mitmweb'de isteğe sağ tıklayıp Export → curl seçebilirsiniz: geliştiricinin bir saniyede kendinde yeniden üretebileceği bir komut elde edersiniz. Charles'ta aynı şekilde: sağ tık → Copy cURL Request.
  3. İyi bir ağ hatası hata raporu her zaman şunları içerir: adımlar, yöntemli URL, yanıt kodu ve gövdesi, istek zamanı (sunucu günlüklerinde bulmak için) ve backend döndürüyorsa başlıklardan istek tanımlayıcısı (genellikle X-Request-Id).

İsteği duraklatıp yanıtı değiştiriyoruz

Klasik senaryo: uygulamanın yüz ürünlü bir sepeti veya negatif fiyatı nasıl göstereceğini kontrol etmek gerekiyor ama ortamda böyle veriler yok. Yanıtı değiştiriyoruz.

  1. mitmweb'de Intercept alanına bir filtre girin, örneğin ~u /cart. Artık bu URL'li tüm istekler duracak. Uygulamada eylemi gerçekleştirin. İstek intercepted işaretiyle görünecek. Üzerine tıklayın, Response sekmesinde (kalem simgesi) yanıtı düzenledikten sonra Resume'a basın. Uygulama değiştirilmiş verileri alacak.
  2. Charles'ta Breakpoints'i açın: isteğe sağ tıklayın → Breakpoints. Bir sonraki böyle istekte iki fazlı bir pencere açılacak: önce Edit Request, sonra Edit Response. Response sekmesinde JSON'u değiştirin ve Execute'e basın.
  3. Uygulamaların bir zaman aşımı olduğunu unutmayın, genellikle 10-30 saniye. Yanıtı bundan daha uzun süre düzenlerseniz, uygulama verileriniz yerine ağ hatası gösterir. JSON'u önceden metin düzenleyicide hazırlayın ve tamamen yapıştırın.

Kalıcı yanıt değişikliği: Map Local

Senaryo tekrarlanıyorsa manuel duraklatmalar rahatsız edicidir. Charles'ta Tools → Map Local var: URL'yi ve JSON'lu yerel dosyayı belirtirsiniz ve her böyle istek ortam yanıtı yerine dosya içeriğini alır. mitmproxy'de eşdeğeri — map_local seçeneğiyle URL şablonu ve dosya yolu belirtmek, ayrıca herhangi bir alanı değiştirebilen response fonksiyonlu küçük Python scriptleri. Örneğin beş satırlık bir script tüm ortam yanıtlarında balance alanının değerini istediğiniz sayıyla değiştirebilir.

Sunucu hatalarını simüle ediyoruz

Uygulama 500, 401 veya boş yanıt durumunda nasıl davranıyor? Ortamda kontrol etmek zor, proxy üzerinden kolay. Charles'ta: Tools → Rewrite → ortam URL'si için Response Status tipinde ve 500 değerinde bir kural ekleyin. mitmproxy'de: kesme modunda yanıt düzenleyicide durum kodunu değiştirin veya flow.response.status_code = 500 ile bir script kullanın. Uygulamanın anlaşılır bir hata gösterdiğinden, çökmediğinden ve sonsuz yükleyicide takılı kalmadığından emin olun.

Yavaş ağı simüle ediyoruz

Charles'ta Proxy → Throttle Settings'i açın, 3G ön ayarını seçin veya kendi değerlerinizi girin: bant genişliği, gecikme, kayıp yüzdesi. Throttle'ı sadece ortam ana makinesiyle sınırlamayı unutmayın, yoksa diğer bağlantılar da yavaşlar. Liste yüklemelerini, ekrandan çıkarken istek iptalini ve zaman aşımı davranışını test edin. Android emülatörü de ağı sınırlayabilir: Extended Controls → Cellular → Network type, ancak proxy daha ince kontrol verir.

Uygulamayı yerel backend'e yönlendiriyoruz

Sık bir görev: geliştirici dizüstü bilgisayarında 3000 portunda bir sunucu başlattı ve ortama çıkmadan önce özelliği kontrol etmenizi istiyor. Gerçek telefondaki uygulama onun localhost'unu görmez. Çözüm — yine adb reverse:

adb reverse tcp:3000 tcp:3000

Şimdi uygulamada (gizli ortam seçimi menüsü veya QA derlemesindeki base URL ayarı aracılığıyla) http://localhost:3000 adresini belirtin ve istekler bilgisayara gidecek. Aynı anda yakalama gerekiyorsa proxy'yi açık bırakın: mitmproxy localhost:3000'e istekleri normal olarak görecek. Emülatörde adb reverse yerine sadece http://10.0.2.2:3000 adresini kullanabilirsiniz.

İpucu: Oturumları kaydedin. Charles'ta — File → Save Session, mitmproxy'de — mitmdump -w session.mitm komutu veya mitmweb'de kaydetme düğmesi. Hatayı yeniden üreten bir oturum dosyası, herhangi bir açıklamadan daha değerlidir: geliştirici onu açacak ve tüm istekleri sizde gittiği sırayla görecek.

Kontrol: Şunları yapabilirsiniz: sadece ortama yapılan istekleri göstermek; herhangi bir isteği curl olarak kopyalamak; bir isteği durdurup uygulamaya ekranda görüntülenen değiştirilmiş JSON döndürmek; uygulamaya 500 kodu aldırıp tepkisini görmek; ağı yavaşlatıp yükleme göstergesini görmek. Beş maddenin hepsi başarılıysa — proxy'yi kendinden emin bir kullanıcı düzeyinde öğrendiniz.

Sonucu kontrol etme: nihai kontrol listesi

Listeyi geçin ve her maddeyi işaretleyin. Günlük işe tam hazır bir ortam için hepsinin yapılması gerekir.

Bilgisayarda proxy

  • mitmweb veya Charles hatasız başlıyor ve portunu dinliyor.
  • curl -x http://127.0.0.1:8080 -k https://example.com komutu arayüzde isteği gösteriyor.
  • Kök sertifika dosyası bulundu ve nerede olduğunu biliyorsunuz.

Emülatör

  • adb devices emülatörü device durumunda gösteriyor.
  • adb shell settings get global http_proxy 10.0.2.2:8080 döndürüyor veya Extended Controls panelinde durum Success.
  • Emülatördeki Chrome HTTPS sitelerini uyarısız açıyor.
  • Sertifika güvenlik ayarlarında Kullanıcı sekmesinde görünüyor.
  • Test uygulaması çalışıyor, ortama istekleri çözülmüş gövdelerle görünüyor.

Gerçek cihaz

  • USB hata ayıklama açık, adb devices telefonu görüyor.
  • Wi-Fi ile: bilgisayarın IP'sinde proxy, mitm.it açılıyor, uygulama istekleri görünüyor.
  • USB ile: adb reverse --list tcp:8080 gösteriyor, 127.0.0.1:8080 proxy'si ayarlı, bilgisayarın Wi-Fi'si kapalıyken mitm.it açılıyor.
  • Proxy'yi ve yönlendirmeyi kapatmayı biliyorsunuz ve kapatma sonrası telefon normal şekilde internete çıkıyor.

Ortamla çalışma

  • Ortam alan adına göre filtre ayarlı.
  • Duraklatma veya Map Local ile en az bir yanıt değişikliği yapıldı.
  • Uygulamanın 500 koduna tepkisi kontrol edildi.
  • Trafik örnekli bir oturum kaydedildi.

Kendi kendini kontrol için test senaryosu

  1. Proxy'yi, emülatörü başlatın ve emülatörde proxy'yi açın.
  2. Uygulamayı açın, oturum açın, herhangi bir veri listesini açın.
  3. Proxy'de bu listeyi döndüren isteği bulun. URL'sine kesme koyun.
  4. Uygulamada listeyi yenileyin, durdurulan yanıtta öğelerin yarısını silin, bırakın.
  5. Uygulama ekranında daha az öğe görünmelidir. Görünüyorsa — ortam tamamen çalışır durumda.

Tipik hatalar ve çözümleri

Sorun 1: Uygulama ağ hatası gösteriyor, tarayıcı çalışıyor

Neden: uygulama kullanıcı sertifikasına güvenmiyor (Android 7+ varsayılan davranışı) veya certificate pinning açık. Çözüm: network_security_config'li ve debug-overrides bloklu bir debug derlemesi veya ortam için pinning kapatılmış bir QA derlemesi isteyin. Google APIs emülatöründe geçici seçenek olarak — sistem sertifikası. Nedeni bulmaya adb logcat'in Trust veya pinning kelimesine göre filtrelenmesi yardımcı olur.

Sorun 2: Proxy ayarlı olmasına rağmen hiç istek yok

Neden: uygulama sistem proxy'sini yok sayan bir ağ kütüphanesi kullanıyor. Flutter uygulamaları (dart:io istemcisi), bazı React Native derlemeleri ve gRPC uygulamaları böyle davranır. Çözüm: Flutter için geliştirici debug derlemesine proxy ayarlarını okuyan paket aracılığıyla sistem proxy desteği ekler veya hata ayıklama modunda findProxy'yi açıkça 10.0.2.2:8080 olarak ayarlar. Bu standart bir istektir, Flutter geliştiricileri bunu bilir. Alternatif — şeffaf proxy modu, ancak daha karmaşıktır ve burada ele alınmıyor.

Sorun 3: Test sonrası telefon internetsiz

Neden: proxy Wi-Fi ayarlarında veya global http_proxy ayarında kaldı, ancak proxy sunucusu kapatıldı veya kablo çıkarıldı. Çözüm: adb shell settings put global http_proxy :0 ve Wi-Fi ayarlarında proxy'yi "Yok" konumuna getirin. Bu eylemi çalışma ritüelinizin sonuna ekleyin.

Sorun 4: adb cihazı görmüyor

Neden: kablo sadece şarj için, hata ayıklama isteği onaylanmadı, Windows'ta sürücü kurulu değil, cihaz "Dosya aktarımı" yerine "Sadece şarj" modunda. Çözüm: kabloyu değiştirin, telefon ekranını kontrol edin, bildirim çekmecesinden USB modunu "Dosya aktarımı"na geçirin, Windows'ta SDK Manager üzerinden Google USB Driver veya üretici sürücüsünü kurun. adb kill-server ve ardından adb start-server da yardımcı olur.

Sorun 5: Charles sadece içeriksiz CONNECT gösteriyor

Neden: SSL Proxying açık değil veya alan adı Include'a eklenmemiş. Çözüm: Proxy → SSL Proxying Settings → Enable → Add ana makine * port 443. Açtıktan sonra uygulamayı yeniden açın: zaten kurulmuş bağlantılar geriye dönük çözülmez.

Sorun 6: Emülatör panelinde Proxy status: Error

Neden: bilgisayardaki proxy çalışmıyor veya port farklı. Bazen — Android Studio kendi proxy'siyle ayarları yakalar. Çözüm: proxy'yi başlatın, Android Studio ayarlarını kullanma onay kutusunu kaldırın, Apply'e tekrar basın. İşe yaramazsa — proxy'yi 10.0.2.2 adresli adb komutuyla ayarlayın.

Sorun 7: mitm.it açılmıyor ama diğer internet çalışıyor

Neden: trafik proxy'yi atlıyor. Wi-Fi üzerinden gerçek cihazda genellikle ağdaki istemci izolasyonu suçludur. Çözüm: bilgisayardan telefona ping atın. Yanıt yoksa — adb reverse'a geçin. Yanıt varsa — güvenlik duvarını ve portu kontrol edin.

Sorun 8: Android Studio güncellemesinden sonra sertifika kayboldu

Neden: emülatörün Wipe Data'sını yaptınız veya yeniden oluşturdunuz. Çözüm: kullanıcı sertifikası mitm.it üzerinden bir dakikada yüklenir. Durumu kaybetmemek için emülatör anlık görüntülerini kullanın (Extended Controls'te Snapshots): sertifika ve uygulama yüklendikten sonra bir anlık görüntü kaydedin.

Sorun 9: Birden fazla cihaz ve komutlar yanlış yere uygulanıyor

Neden: iki veya daha fazla bağlı cihazla adb -s bayrağı olmadan çalışmayı reddeder veya beklenmedik bir cihazla çalışır. Çözüm: her zaman adb -s seri_numarası kullanın, seri numaralarını adb devices ile görün. ANDROID_SERIAL ortam değişkenini istediğiniz numarayla ayarlayabilirsiniz.

İleri düzey testçiler için ek olanaklar

iOS simülatörü ve gerçek iPhone

Mantık aynı, araçlar farklı. iOS simülatörü macOS'un ağ ayarlarını kullanır, bu yüzden proxy Mac'teki sistem Ağ ayarlarında belirtilir ve sertifika simülatör penceresine sürüklenip Ayarlar → Genel → Bu cihaz hakkında → Sertifika ayarları → Sertifika güven ayarları'ndan etkinleştirilir. Gerçek iPhone'da proxy Wi-Fi özelliklerinde belirtilir, sertifika mitm.it üzerinden indirilir ve aynı güven yoluyla etkinleştirilir. iPhone için USB üzerinden adb reverse eşdeğeri yoktur; kapalı ağlarda Mac'ten kabloyla internet paylaşımı kullanılır.

mitmdump ve scriptlerle otomasyon

mitmdump arayüz olmadan çalışır ve Python scriptlerini kabul eder. Örnek görev: tüm ortam yanıtlarında feature_flags alanını değiştirerek yönetici paneline erişmeden deneysel bir özelliği açmak. Script -s script.py bayrağıyla başlatılır ve trafik -w bayrağıyla dosyaya yazılır. Bu tür scriptleri otomatik testlerin yanında test deposunda saklamak uygundur.

Appium ve otomatik testlerle entegrasyon

Otomatik testlerde proxy oturum başlatılmadan önce açılır: adb üzerinden ayar, ardından yalnızca UI değil trafik üzerinden de doğrulama yapılır. Örneğin, test "Öde" düğmesine basar ve mitmproxy'de doğru tutarlı /payments'a bir POST göründüğünü kontrol eder. Bu, UI'nin göstermediği hataları yakalar: isteklerin çoğaltılması, gereksiz alanların gönderilmesi, yanlış tarih formatı.

Analitik ve izleme kontrolü

Proxy, analitik olaylarını test etmek için vazgeçilmezdir: uygulamanın her eylemde hangi olayları hangi parametrelerle gönderdiğini görürsünüz. Analitik sistemi alan adına göre filtre ve istek gövdesi sütunu, gösterge panellerinde olayların görünmesini uzun süre beklemenin yerini alır.

Farklı proxy'li birden fazla emülatör

Ortamın farklı yanıtlarındaki davranışı karşılaştırmanız gerekiyorsa, 8080 ve 8090 portlarında iki proxy ve her biri adb -s üzerinden kendi proxy'siyle iki emülatör başlatın. Bu şekilde A/B varyantlarını kontrol etmek uygundur: bir emülatör Map Local üzerinden değiştirilmiş yanıt alır, diğeri orijinali.

Emülatör anlık görüntüleri temiz ortam olarak

Proxy, sertifika ve uygulama ayarlandıktan sonra emülatör anlık görüntüsünü kaydedin. Her test koşusundan önce onu yükleyin — saniyeler içinde yeniden yükleme olmadan aynı ortamı elde edersiniz.

Ortamların ayrılması ve güvenlik

Farklı projeler için ayrı Charles profilleri veya mitmproxy yapılandırmaları tutun. Bilgisayarda tüm trafiği sistem genelinde yakalamayı açmayın — yalnızca cihazların trafiği. Ve test cihazlarında kişisel hesap olmadığını düzenli olarak kontrol edin, çünkü tüm trafikleri proxy'de görünür.

SSS: Mobil testte proxy ayarı hakkında sık sorulan sorular

adb reverse ile adb forward arasındaki fark nedir?

adb reverse cihazdaki bir portu bilgisayara yönlendirir: telefondaki uygulama localhost'a başvurur ve PC'ye ulaşır. adb forward — tam tersi: bilgisayarın portu cihaza yönlendirir, böylece örneğin telefondaki hata ayıklayıcıya veya web sunucusuna bağlanılır. Proxy ve yerel backend için tam olarak reverse gerekir.

Sadece istek URL'leriyle ilgileniyorsam sertifika yüklemek zorunlu mu?

Hayır. Sertifikasız ana makineleri ve CONNECT isteklerini görürsünüz, ancak yolları, parametreleri ve gövdeleri değil. Ancak uygulama bu durumda TLS hataları alacak, yani normal şekilde test edilemez. Pratikte sertifika her zaman yüklenir.

Emülatörde bilgisayar adresi 10.0.2.2 iken neden Extended Controls panelinde 127.0.0.1 yazmalı?

Emülatör paneli proxy'yi ana makine tarafında uygular, bu yüzden orada bilgisayarın adresi 127.0.0.1'dir. adb shell komutu ise Android içinde çalışır, orada 127.0.0.1 emülatörün kendisidir ve bilgisayara 10.0.2.2 üzerinden erişilir. Kuralı unutmayın: Android içinde — 10.0.2.2, dışında — 127.0.0.1.

Root olmadan cihazda proxy kullanılabilir mi?

Evet. Kılavuzda anlatılan her şey, sistem sertifikası yükleme hariç, root olmadan çalışır. Anahtar koşul — kullanıcı sertifikalarına güvenen bir debug derlemesi.

Derleme güncellendikten sonra uygulama proxy üzerinden çalışmayı bıraktıysa ne yapmalı?

Muhtemelen geliştiriciler pinning'i açtı veya debug-overrides'ı kaldırdı. adb logcat'te sertifika hatalarını kontrol edin ve ekipten ağ yapılandırmasında neyin değiştiğini sorun. Bu genellikle yeni bir HTTP istemci kütüphanesine geçişte olur.

Wi-Fi yerine mobil internet kullanırken uygulamayı proxy üzerinden nasıl test ederim?

USB üzerinden adb reverse ve global http_proxy 127.0.0.1:8080 ayarını kullanın. Çoğu cihazda proxy mobil verilere de uygulanır. Uygulanmıyorsa — Wi-Fi üzerinden test edin, ağ geçiş senaryolarını ayrı olarak proxy'siz kontrol edin.

Mağazadan üretim sürümünün trafiği yakalanabilir mi?

Teknik olarak sürüm derlemeleri kullanıcı sertifikalarına güvenmez ve genellikle pinning içerir, bu yüzden değişiklik olmadan çalışmaz. Ve bu doğrudur: kullanıcı güvenliği testçinin rahatından daha önemlidir. Tüm kontrolleri test derlemelerinde ve ortamda yapın.

İsteğin uygulamadan mı, arka plan servisinden mi, tarayıcıdan mı geldiğini nasıl anlarım?

Charles'ta macOS'ta Client Process sütunu vardır, ancak cihazda süreç bilgisi iletilmez. Pratik yöntem: diğer tüm uygulamaları kapatın, ortam alan adına göre filtreleyin ve eylemi noktasal olarak yeniden üretin. Şüpheli durumlarda User-Agent başlığına bakın — uygulamalar genellikle kendi adını ve sürümünü ekler.

Trafiği nasıl kaydedip geliştiriciye iletebilirim?

Charles'ta — File → Save Session As .chls formatında veya HAR formatında Export. mitmproxy'de — kayıt için -w bayrağı veya web arayüzünden kaydetme. HAR neredeyse her araç tarafından okunur, tarayıcı geliştirici araçlarındaki Network sekmesi dahil.

İlk seferden sonra günlük kurulum ne kadar sürer?

Proxy'yi, anlık görüntüden emülatörü başlatmak ve adb üzerinden proxy'yi açmak — yaklaşık bir dakika. USB üzerinden gerçek cihaz — iki komut ve on saniye. Sertifika ayarı yalnızca cihaz sıfırlandıktan sonra tekrarlanır.

Sonuç

Özetleyelim. Bilgisayarda kesici proxy'yi ayağa kaldırdınız ve trafiği gördüğünden emin oldunuz. Android emülatörünü üç farklı şekilde ona yönlendirdiniz ve 127.0.0.1 ile 10.0.2.2 adreslerini çözdünüz. Kök sertifikayı yüklediniz ve uygulamanın ona neden güvenmeyebileceğini ve geliştiricilerden tam olarak ne istemeniz gerektiğini anladınız. Gerçek cihazı Wi-Fi üzerinden bağladınız, ofis ağlarının kısıtlamalarıyla karşılaştınız ve bunları adb reverse ile port yönlendirerek çözdünüz. Ortam trafiğini filtrelemeyi, istekleri duraklatmayı, yanıtları değiştirmeyi, sunucu hatalarını ve yavaş ağı simüle etmeyi ve uygulamayı meslektaşınızın yerel backend'ine yönlendirmeyi öğrendiniz.

Bu, ağ hatalarını bağımsız olarak bulup yerelleştirebilen bir mobil uygulama testçisini ayıran beceri setidir. Hata raporlarınız daha isabetli olacak ve geliştiriciler hazır curl komutları ve oturum dosyaları için minnettar olacak.

Bundan sonra ne yapmalı

  • Kurulumu kendi iş projenizde tekrarlayın, ortama çözülmüş isteklerin görünmesini sağlayın.
  • adb komutlarından kişisel bir kopya kağıdı yapın ve hazır ortamlı emülatör anlık görüntüsünü kaydedin.
  • Bir özelliğin tam test döngüsünü açık proxy ile yapın ve trafik görünürlüğü sayesinde kaç hata bulunduğunu sayın.

Nereye gelişmeli

Sonraki seviye — yanıtları otomatik olarak değiştiren mitmproxy için Python scriptleri, trafik kontrollerinin Appium otomatik testlerine entegrasyonu ve mobil istemciyle paralel olarak Postman veya curl üzerinden ortam API'sinin doğrudan test edilmesi. pinning ve ağ güvenliği yapılandırması hakkında geliştiricilerle kendinden emin konuşmak için TLS temellerini ve sertifika yapısını öğrenmek faydalıdır. Ve mutlaka iOS tarafını öğrenin: her iki istemciyi de test eden komutlar, her iki platformda da eşit derecede kendinden emin olan uzmanları takdir eder. Her şey yolunda gidecek — en zorunu çoktan yaptınız.