एपीएन और CarrierConfig

कैरियर, Android Open Source Project (AOSP) में ऐक्सेस पॉइंट नेम (एपीएन) की जानकारी और कैरियर के हिसाब से कॉन्फ़िगरेशन सेटिंग (CarrierConfig) अपडेट कर सकते हैं.

अपने कॉर्पोरेट ईमेल पते से बनाया गया Google खाता

एपीएन की जानकारी या CarrierConfig अपडेट करने के लिए, आपको ऐसे Google खाते का इस्तेमाल करके अनुरोध सबमिट करना होगा जिससे कॉर्पोरेट ईमेल पता जुड़ा हो. उदाहरण के लिए, Acme कंपनी से एपीएन अपडेट करने का अनुरोध, foobar@acme.com जैसे ईमेल पते से आना चाहिए.

अगर आपके पास ऐसा Google खाता नहीं है जो आपके कॉर्पोरेट ईमेल पते से लिंक हो, तो अपने ब्राउज़र से सभी Gmail खातों से साइन आउट करें. हमारा सुझाव है कि आप निजी ब्राउज़िंग सुविधा का इस्तेमाल करें, जैसे कि गुप्त विंडो. इससे आपको अपने अन्य खातों के साथ भ्रमित होने से बचने में मदद मिलेगी. इसके बाद, अपने कॉर्पोरेट ईमेल पते से एक Google खाता बनाएं.

लोकल डेवलपमेंट एनवायरमेंट तैयार करना

अगर आपने AOSP में पहले कभी कोड सबमिट नहीं किया है, तो आपको इन बातों का ध्यान रखना होगा:

इसके अलावा, हमारा सुझाव है कि बदलावों को ट्रैक करने के लिए, Google Issue Tracker का इस्तेमाल करें.

गड़बड़ी की शिकायत करें

  1. issuetracker.google.com पर जाएं और अपने कॉर्पोरेट ईमेल पते का इस्तेमाल करके साइन इन करें. अपने कॉर्पोरेट ईमेल पते से जुड़ा Google खाता लेख पढ़ें.
  2. लॉग इन करने के बाद, स्क्रीन की बाईं ओर मौजूद समस्या की जानकारी दें पर क्लिक करें.
  3. कॉम्पोनेंट में, Android Public Tracker > फ़्रेमवर्क चुनें
  4. टाइटल और ब्यौरा डालने के लिए, APN अपडेट या CarrierConfig अपडेट पर जाएं.

एपीएन से जुड़ी गड़बड़ी

बग एट्रिब्यूट को इस तरह सेट करें:

टाइटल: CarrierXYZ के लिए एपीएन जोड़ें/बदलें/हटाएं

ब्यौरा: जिन बदलावों का अनुरोध किया जा रहा है उनके बारे में पूरी जानकारी दें. इसमें एपीएन सेटिंग भी शामिल करें.

मोबाइल और इंटरनेट सेवा देने वाली कंपनी के कॉन्फ़िगरेशन से जुड़ी गड़बड़ी

बग एट्रिब्यूट को इस तरह सेट करें:

टाइटल: CarrierXYZ के लिए कॉन्फ़िगरेशन में बदलाव

जानकारी: जिन बदलावों का अनुरोध किया जा रहा है उनके बारे में पूरी जानकारी दें.

परिवर्तन सबमिट करें

बदलाव करने के लिए:

  1. पहचानें कि आपको किस फ़ाइल में बदलाव करना है.
  2. फ़ाइल में बदलाव करें.
  3. पैच सबमिट करने के निर्देशों का पालन करके, अपनी लोकल रिपॉज़िटरी में बदलावों को सेव करें. साथ ही, कमिट मैसेज के दिशा-निर्देशों का पालन करें. इसमें सुझाया गया फ़ॉर्मैट भी शामिल है.
  4. अपनी निजी हिस्ट्री में बदलाव करने के बाद, repo upload कमांड का इस्तेमाल करके, उसे Gerrit पर अपलोड करें.
  5. अपलोड हो जाने के बाद, repo, Gerrit पर मौजूद एक नए पेज का यूआरएल देता है. इस यूआरएल का इस्तेमाल इन कामों के लिए करें:
    • समीक्षा सर्वर पर अपना पैच देखना
    • टिप्पणी जोड़ना
    • अपने पैच की समीक्षा करने के लिए, समीक्षकों से अनुरोध करना

एपीएन सिंटैक्स

Android प्रोजेक्ट का नाम - डिवाइस/सैंपल

फ़ाइल का नाम - etc/apns-full-conf.xml (Google Git का मुख्य लिंक)

इस फ़ाइल में, एपीएन सेटिंग एक्सएमएल फ़ॉर्मैट में होती हैं. यह एक सैंपल फ़ाइल के तौर पर काम करती है, इसलिए Android डिवाइसों के व्यवहार में कोई बदलाव नहीं होता.

एपीएन का सामान्य कॉन्फ़िगरेशन ऐसा दिखता है:

<apn carrier="CarrierXYZ"
      mcc="123"
      mnc="123"
      apn="carrierxyz"
      type="default,supl,mms,ims,cbs"
      mmsc="http://mms.carrierxyz.com"
      mmsproxy="0.0.0.0"
      mmsport="80"
      bearer_bitmask="4|5|6|7|8|12"
/>

टेस्ट करना

  1. उस Android डिवाइस को कनेक्ट करें जिसके लिए आपके पास रूट ऐक्सेस है.
  2. /etc/apns-conf.xml में सेटिंग जोड़ें.
  3. एपीएन सेटिंग रीसेट करें.
  4. APN सेटिंग में जाकर, पुष्टि करें कि प्रोफ़ाइलें सही तरीके से लोड हुई हैं.
  5. हर प्रोफ़ाइल के लिए, डेटा कनेक्टिविटी, वाई-फ़ाई हॉटस्पॉट, और एमएमएस की जांच करें, ताकि यह पक्का किया जा सके कि वे सही तरीके से काम कर रहे हैं.

कमिट मैसेज

[Example - "Add CarrierXYZ apns to sample apns"]
Bug: [Issue ID from Google Issue Tracker]
Test: No change to behavior as this is only a sample file

सीएल का सैंपल

उदाहरण के लिए, BICS APNs का सैंपल देखें.

CarrierConfig सिंटैक्स

प्रोजेक्ट का नाम - platform/packages/apps/CarrierConfig

फ़ाइल का नाम - assets/carrier_config_.xml (Google Git का मुख्य लिंक)

सही एमसीसी/एमएनसी टपल के हिसाब से, ऐसेट फ़ोल्डर में मौजूद सही एक्सएमएल फ़ाइल(फ़ाइलों) की पहचान करें. इस फ़ाइल में, कैरियर कॉन्फ़िगरेशन ऑब्जेक्ट को एक्सएमएल फ़ॉर्मैट में सेव किया जाता है. एट्रिब्यूट के नाम, CarrierConfigManager में कुंजियों के तौर पर तय किए जाते हैं. साथ ही, वैल्यू का टाइप (int/string/bool) सफ़िक्स से पता चलता है.

आम तौर पर, int/string/bool एट्रिब्यूट इस तरह दिखते हैं:

<int name="vvm_port_number_int" value="5499" />
<string name="vvm_type_string">vvm_type_omtp</string >
<boolean name="vvm_cellular_data_required_bool" value="true" />

कमिट मैसेज

[Example - "Add VVM settings for CarrierXYZ"]

[Example - "Updated <mccmnc> carrier config file to include VVM settings
as defined by CarrierXYZ."]

Bug: [Issue ID from Google Issue Tracker]
Test: [Testing notes]

सीएल का सैंपल

उदाहरण के लिए, किसी सीएल के लिए अपडेट की गई कैरियर कॉन्फ़िगरेशन फ़ाइल देखें.

समीक्षा का अनुरोध करें

समीक्षा का अनुरोध करने के लिए:

  • अपने बदलाव के Gerrit यूआरएल पर जाएं और android-carrier-config-review@google.com को समीक्षक के तौर पर जोड़ें.
  • Gerrit पर, Google के अपने संपर्क को भी सीसी सूची में जोड़ा जा सकता है.
  • ट्रैकिंग के लिए, समस्या को असाइन किए गए व्यक्ति को android-carrier-config-review@google.com पर बदला जा सकता है.

जब कोई सबमिशन, समीक्षा और पुष्टि की प्रोसेस पूरी कर लेता है, तो Gerrit उस बदलाव को सार्वजनिक रिपॉज़िटरी में अपने-आप मर्ज कर देता है. अन्य उपयोगकर्ता, अपने लोकल क्लाइंट में अपडेट पाने के लिए repo sync चला सकते हैं.