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

اختيار النظام الأساسي: Android (إصدار تجريبي) جديد Android

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

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

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

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

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

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

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

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

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

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

من الأسهل استخدام المحاكي مع خادم وكيل لأنّ المحاكي متّصل بشبكة Wi-Fi نفسها التي يتّصل بها الكمبيوتر الذي يتم تشغيل Charles عليه. عند استخدام المحاكي مع خادم وكيل، اضبط الخادم الوكيل على المضيف المحلي (http://127.0.0.1) والمنفذ الذي يتم تشغيل خادم Charles الوكيل عليه (يمكنك العثور عليه في خيار القائمة الخادم الوكيل (Proxy) > إعدادات الخادم الوكيل (Proxy Settings) في Charles).

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

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

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

أولاً، عليك إضافة ملف جديد لمورد XML لإعداد أمان الشبكة ضمن

<network-security-config>
   <debug-overrides>
       <trust-anchors>
           <!-- 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.