إعداد خادم Charles الوكيل

اختيار النظام الأساسي: Android Android (قديم)

في نظام التشغيل Android N أو الإصدارات الأحدث، لا تظهر طلبات عرض الإعلانات في خادم وكيل Charles إلا عند تنفيذ الخطوات التالية:

  1. تحديث "خدمات Google Play" على الجهاز الجوّال
  2. فعِّل تتبُّع الشبكة على الجهاز الجوّال.
  3. ثبِّت شهادة طبقة المقابس الآمنة (SSL) في Charles على جهازك، وأعِدّ الخادم الوكيل.
  4. فعِّل خادم وكيل طبقة المقابس الآمنة لتطبيقك على الأجهزة الجوّالة.

تحديث "خدمات Google Play" على الجهاز الجوّال

بالنسبة إلى المحاكي، إذا لم يظهر لك قسم Google Play في القائمة الجانبية، قد تحتاج إلى تحديث "استوديو Android". نزِّل أحدث صور النظام في إعدادات الجهاز الافتراضي، واستخدِم صورة نظام مع Google Play في هدفها.

استخدِم القائمة الجانبية للتحقّق من تثبيت أحدث إصدار من "خدمات Google Play" وتحديثه.

بالنسبة إلى الأجهزة الجوّالة (الهواتف أو الأجهزة اللوحية)، يمكنك البحث عن Google Play أو النقر على هذا الرابط لفتح Google Play مباشرةً.

تفعيل تتبُّع الشبكة على الجهاز الجوّال

لتفعيل تتبُّع الشبكة، يجب تفعيل خيارات المطوّرين على جهازك. لمعرفة التفاصيل، يُرجى الاطّلاع على المقالة ضبط خيارات المطوّرين على الجهاز فقط.

افتح تطبيق "إعدادات Google" واختَر Google > الإعلانات > تفعيل تسجيل بيانات تصحيح الأخطاء للإعلانات. لمعرفة التفاصيل، يُرجى الاطّلاع على تتبُّع الشبكة.

تثبيت شهادة طبقة المقابس الآمنة (SSL) في Charles على جهازك وإعداد الخادم الوكيل

لاستخدام Charles كخادم وكيل لتطبيقك، نزِّل Charles وثبِّته على جهاز الكمبيوتر.

لحفظ الشهادة كملف .pem أو .cer، اختَر مساعدة > الخادم الوكيل لطبقة المقابس الآمنة > حفظ شهادة الجذر لبرنامج Charles. لتثبيت الشهادة على جهازك، اتّبِع التعليمات في المساعدة > خادم وكيل طبقة المقابس الآمنة (SSL).

إذا كنت تستخدم Android Emulator مع خادم وكيل، اضبط عنوان الخادم الوكيل على http://127.0.0.1. اضبط المنفذ على القيمة المعروضة في Charles من الخادم الوكيل > إعدادات الخادم الوكيل.

إذا كنت تستخدم جهازًا فعليًا، فقم بتوصيل الجهاز بنفس شبكة Wi-Fi مثل جهاز الكمبيوتر الخاص بك. لإعداد الخادم الوكيل، افتح إعدادات الشبكة المتقدّمة على جهازك. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة الاتصال بشبكات Wi-Fi على هاتف Pixel. في Charles، اختَر Help > Local IP Address للعثور على عنوان IP. على جهازك، أدخِل عنوان IP من Charles ومنفذ Charles كخادم وكيل.

تفعيل خادم وكيل طبقة المقابس الآمنة لتطبيقك على الأجهزة الجوّالة

لكي يتمكّن Charles من اعتراض زيارات طبقة المقابس الآمنة (SSL) لتطبيقك على الأجهزة الجوّالة، يجب الإعلان عن أنّ تطبيقك يمكنه الوثوق بشهادة طبقة المقابس الآمنة (SSL). يمكنك الوثوق بشهادة ثبّتها المستخدم أو تضمين شهادة Charles كمورد أوّلي في تطبيقك. على سبيل المثال، يمكنك حفظ الشهادة في ملف res/raw/charles_cert.pem.

أولاً، أضِف ملف موارد XML جديدًا لإعدادات أمان الشبكة في ملف res/xml/network_security_config.xml:

<network-security-config>
   <debug-overrides>
       <trust-anchors>
           <!-- Trust Charles SSL certificate stored in res/raw -->
           <certificates src="@raw/charles_cert" />
           <!-- Trust user added CAs while debuggable only -->
           <certificates src="user" />
       </trust-anchors>
   </debug-overrides>
</network-security-config>

بعد ذلك، عليك تعديل ملف AndroidManifest.xml لاستخدام إعدادات أمان الشبكة.

<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application ...
                 android:networkSecurityConfig="@xml/network_security_config"
                 ... >
        ...
    </application>
</manifest>

بعد ذلك، يمكنك تشغيل التطبيق المتوافق مع الأجهزة الجوّالة والبحث عن طلبات عرض الإعلانات في سجلّ Charles.