Mac'ten APK yükleyin ve Android'de hata ayıklayın — terminalli ya da terminalsiz

"Mac'ten APK yükleme" ifadesinin arkasında birbirinden tamamen farklı iki iş saklı ve rehberlerin çoğu bunlardan yalnızca birini yanıtlıyor. Bu sayfa ikisini de yanıtlıyor, ardından insanların asıl sonrasında takıldığı konulara geçiyor: logcat okumak ve macOS'un telefonu görmesini sağlamak. Aşağıdaki her adım düz adb komutlarıyla çalışır; bir arayüzün gerçekten iş azalttığı yerlerde ne yaptığını ve ne yapmadığını açıkça söylüyoruz. Ağustos 2026'da güncellendi.

Önce şunu netleştirin: uygulamayı Mac'te mi, telefonda mı istiyorsunuz?

Bu ifade için çıkan arama sonuçları tam ortadan ikiye bölünmüş durumda ve en üsttekiler yalnızca bir yarısına hitap ediyor. "BlueStacks / NoxPlayer / LDPlayer kurun" diye yanıt veren yazılar ilk soruyu yanıtlıyor: Android yazılımını macOS'un kendisinde çalıştırmak. Bunun için bir emülatör gerekir ve Apple Silicon'da gerçekçi seçenekleriniz Android Studio'nun kendi emülatörü (ücretsiz, arm64 sistem imajları) ya da Google Play Games on PC tarzı ürünlerdir; eski x86 emülatörleri değil.

Buna karşılık masanızda bir telefon veya tablet, İndirilenler klasörünüzde de bir .apk dosyası varsa emülatöre hiç ihtiyacınız yok. Size gereken ADB — yani Android Debug Bridge — ve bir kablo. Sayfanın geri kalanı bununla ilgili.

1. Uygulamayı Mac'in kendisinde çalıştırmak istiyorsanız → emülatör kullanın; aşağıdakilerin hiçbiri geçerli değil.
2. Uygulamayı Mac'e bağlı fiziksel bir Android cihaza göndermek istiyorsanız → okumaya devam edin.

Sıfırıncı adım: USB hata ayıklamayı açın (bu kısım telefonda yapılır)

Hiçbir Mac uygulaması bu anahtarı sizin yerinize çeviremez — Android bunu bilerek cihaz üzerinde elle etkinleştirmenizi şart koşar ve ilk bağlantının telefonun ekranında onaylanması gerekir. Aksini iddia eden her şey yanlıştır.

Windows'un aksine macOS'ta hiçbir USB sürücüsüne gerek yoktur. Bir cihaz görünmüyorsa sebep neredeyse her zaman yalnızca şarj eden bir kablo, bir USB hub'ı ya da onaylanmamış bir yetkilendirme penceresidir.

1. Ayarlar → Telefon hakkında → Yapı numarası üzerine yedi kez dokunun.
2. Ayarlar'a geri dönün → Sistem → Geliştirici seçenekleri → USB hata ayıklama'yı açın.
3. Telefonu Mac'e veri aktarabilen bir kabloyla, hub üzerinden değil doğrudan bağlayın.
4. Telefonda "USB hata ayıklamaya izin verilsin mi?" sorusunu onaylayın ve "Bu bilgisayardan her zaman izin ver" kutusunu işaretleyin.

Terminal yolu: adb install

Bu klasik yöntemdir ve sonunda bir arayüz kullanacak olsanız bile bilmeye değer. Homebrew, Google'ın dağıttığı platform-tools ikili dosyalarının aynısını kurar.

Sık karşılaşılan hatalar, sade biçimde: INSTALL_FAILED_UPDATE_INCOMPATIBLE, aynı paket adına sahip bir uygulamanın zaten kurulu olduğu ama farklı bir anahtarla imzalandığı anlamına gelir — önce onu kaldırın. INSTALL_FAILED_VERSION_DOWNGRADE ise -d eklenerek çözülür. "adb: no devices/emulators found" mesajı, yukarıdaki yetkilendirme adımının tamamlanmadığını gösterir.

1. brew install --cask android-platform-tools
2. adb devices — seri numarası unauthorized veya offline değil, device olarak listelenmeli.
3. adb install -r ~/Downloads/app.apk (-r, mevcut kopyanın üzerine veriyi koruyarak yeniden kurar).
4. Success çıktısını bekleyin; INSTALL_FAILED_ ile başlayan her şey asıl hata mesajıdır.

Terminalsiz yol: APK'yı pencereye sürükleyin

Terminalde yaşamayacaksanız Homebrew kurulumu, PATH düzenlemeleri ve cd platform-tools dansı tamamen fazladan yüktür. Super ADB Manager, adb'yi ve scrcpy sunucusunu uygulamanın içinde taşır; yanına ayrıca kuracağınız ya da ayrıca güncel tutacağınız hiçbir şey yoktur.

Ücretsizdir, hesap istemez, reklam göstermez ve telemetri varsayılan olarak kapalıdır. Uygulama Apple tarafından imzalanmış ve notarize edilmiştir; bu yüzden toplu indirme sitelerindeki imzasız araçların dayattığı sağ tık → Aç geçici çözümü yerine normal şekilde açılır.

1. DMG'yi indirin, uygulamayı Uygulamalar klasörüne sürükleyin ve açın.
2. Telefonu takın ve USB hata ayıklama iznini onaylayın (yukarıdakiyle aynı).
3. Cihazı seçin, Uygulamalar sekmesini açın ve ya APK Yükle'ye basın ya da .apk dosyasını doğrudan pencereye bırakın.
4. Aynı sekme kurulu paketleri listeler; uygulamayı açabilir, APK'sını Mac'e geri çekebilir, verilerini temizleyebilir veya uygulamayı kaldırabilirsiniz.

Bölünmüş APK'lar: base.apk artı yapılandırma dosyaları

APKMirror'dan App Bundle olarak indirilen ya da SAI ile dışa aktarılan her şey birkaç dosya halinde gelir — base.apk ile birlikte split_config.arm64_v8a.apk, split_config.xxhdpi.apk, dil parçaları ve benzerleri. Yalnızca base.apk'yı kurmak, açılışta çöken ya da hiç kaynak göstermeyen bir uygulamayla sonuçlanır.

Tüm parçalar aynı derlemeden ve aynı imzadan gelmelidir; sürüm karıştırmak başarısız olur. Elinizde bir .xapk veya .apks paketi varsa önce onu açın — ikisi de ZIP arşividir — sonra çıkan parçaları birlikte kurun.

1. Terminal: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. Arayüz: dosya seçicide tüm parçaları aynı anda seçin ya da hepsini birlikte pencereye sürükleyin — uygulama install-multiple'ı sizin yerinize çalıştırır ve kurulum sırasında parça sayısını gösterir.

Android Studio olmadan Mac'te logcat okumak

adb logcat tek başına gayet iyi çalışır ve hızlı bir çökme avı için komut satırı çoğu zaman yeterlidir. Sorun sürekli okumada başlar: ham logcat, cihazdaki her süreçten dakikada binlerce satır demektir.

Buradaki arayüz manzarası cılız ve büyük ölçüde bayat. En bilinen macOS logcat görüntüleyicileri on yıllık bir Objective-C projesi ile onun çatalları, bir Tcl/Tk aracı ve birkaç yeni terminal tarzı Rust yardımcı programı; bir de ücretli ticari seçenek var. Hepsi platform-tools'u kendinizin kurup güncel tutmasını bekliyor ve çoğu imzasız — macOS 13 ve sonrasında bu, tek bir satır görmeden önce Gatekeeper'la boğuşmak demek.

Super ADB Manager'da Logcat sekmesi seçili cihazdan canlı akış verir: öncelik filtresi (Hepsi / Bilgi+ / Uyarı+ / Hata / Kritik), Çökme, Ağ, Sistem ve o an ön plandaki uygulama için hazır filtreler, serbest metin araması, renk kodlaması, otomatik kaydırma ve temizleme. Dürüst bir sınır: görünüm bellekte yalnızca en son 2000 satırı tutar; yani bu, uzun oturumlar için bir arşiv değil, canlı bir hata ayıklama penceresidir — tam bir kayıt için adb logcat çıktısını bir dosyaya yönlendirin.

1. adb logcat -v time — okunabilir zaman damgaları.
2. adb logcat *:E — yalnızca hatalar ve kritik hatalar.
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — tek bir uygulamanın çıktısı.
4. adb logcat -c — hatayı yeniden üretmeden önce arabelleği temizler.
5. adb logcat -v time > ~/Desktop/session.log — her şeyi bir dosyaya kaydeder.

Mac cihazı göremediğinde

Bu konuda kaliteli ve güncel, macOS'a özgü bir sorun giderme sayfası yok; işte sorunu gerçekten çözen sıraya göre kontrol listesi. Bazı Samsung, Xiaomi ve Honor modellerinde ADB bağlanmadan önce bildirim panelinden USB modunun "Yalnızca şarj"dan "Dosya aktarımı"na çevrilmesi de gerekir.

adb devices seri numarasını unauthorized kelimesiyle gösteriyorsa telefon bağlı ve sağlıklıdır — yalnızca onay penceresi eksiktir veya daha önce reddedilmiştir. Yetkilendirmeleri iptal etmek pencerenin yeniden çıkmasını sağlar.

1. Kabloyu değiştirin. Yalnızca şarj eden USB-C kabloları açık ara en yaygın nedendir.
2. Doğrudan Mac'e takın; hub'ları, dockları ve monitör portlarını atlayın.
3. adb kill-server, ardından adb devices ile arka plan sürecini yeniden başlatın.
4. Geliştirici seçenekleri → USB hata ayıklama yetkilendirmelerini iptal et, sonra kabloyu çıkarıp tekrar takın.
5. system_profiler SPUSBDataType | grep -i -A4 android — burada hiçbir şey görünmüyorsa sorun ADB'de değil, donanımda ya da kablodadır.

Kablosuz hata ayıklama ve ADB konuşmayan cihazlar

Android 11 ve sonrası, altı haneli bir kodla Wi-Fi üzerinden eşleştirmeyi destekler; USB portu doluyken ya da cihaz bir test düzeneğindeyken bu gerçekten işe yarar. Telefonda gösterilen eşleştirme portu geçicidir ve bağlantı portundan farklıdır. İki makine de aynı alt ağda olmalıdır — istemci yalıtımı açık kurumsal Wi-Fi ağları bunu tamamen engeller. Uygulamada Kablosuz bağlan paneli ağı mDNS üzerinden tarar ve eşleştirme kodunu alır; cihaz USB'deyken Kısayollar → Kablosuza geç tüm devri tek tıkla halleder.

Bundan ayrı olarak, her cihaz ADB konuşmaz. Kindle'lar ve birçok kamera veya medya oynatıcı depolamayı yalnızca MTP üzerinden açar; Google ise hâlâ internetin her yerinde önerilen Android File Transfer'ı kullanımdan kaldırdı. Super ADB Manager, bu cihazlarda ADB olmadan dosya gezinmesi ve aktarımı yapan bir MTP Cihazlar bölümü içerir. Uyarı: aktarımın ortasında cihazın kablosu çıkarılır ya da cihaz çıkartılırsa MTP oturumu düşebilir; kaldığınız yerden devam etmek için yeniden bağlanırsınız.

Gereksinimler ve sınırlar, açıkça: sürüm 0.6.0, yalnızca Apple Silicon, macOS 13 Ventura veya üzeri, yaklaşık 27 MB, notarize edilmiş. Ekran kaydı Android'in screenrecord özelliğine dayanır ve bazı HONOR ile Huawei cihazlarda çalışmaz. Bu bir cihaz yönetimi ve günlük aracıdır, Android Studio'nun hata ayıklayıcısının yerine geçmez — burada kesme noktası veya değişken incelemesi yoktur.

1. Telefon: Geliştirici seçenekleri → Kablosuz hata ayıklama → Cihazı eşleştirme kodu ile eşleştir.
2. Mac: adb pair 192.168.1.20:41234, ardından altı haneli kodu girin.
3. Normal ADB işleri için bağlanmak üzere adb connect 192.168.1.20:5555.
4. Ya da uygulamanın Kablosuz panelini kullanın: tarayın, cihaza dokunun, kodu yazın.

SSS

Diğer rehberler