एपीएन और CarrierConfig

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

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

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

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

स्थानीय डेवलपमेंट एनवायरमेंट तैयार करना

अगर आपने पहले कभी AOSP में कोड सबमिट नहीं किया है, तो आपको अपने बिल्ड एनवायरमेंट को शुरू करना होगा. साथ ही, आपको टूल के बारे में जानकारी हासिल करनी होगी और पैच सबमिट करने का तरीका समझना होगा:

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

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

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

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

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

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

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

CarrierConfig से जुड़ी गड़बड़ी

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

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

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

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

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

  1. यह तय करें कि किस फ़ाइल में बदलाव करना है.
  2. फ़ाइल में बदलाव करें.
  3. पैच सबमिट करने के लिए दिए गए निर्देशों का पालन करके, अपने लोकल रिपॉज़िटरी में बदलावों को कमिट करें. साथ ही, कमिट मैसेज के दिशा-निर्देशों पर ध्यान दें. इनमें सुझाया गया फ़ॉर्मैट भी शामिल है.
  4. अपने निजी इतिहास में बदलाव करने के बाद, repo upload कमांड का इस्तेमाल करके, उसे Gerrit पर अपलोड करें.
  5. अपलोड हो जाने के बाद, रिपॉज़िटरी, 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 APN के सैंपल देखें.

CarrierConfig का सिंटैक्स

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

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

ऐसेट फ़ोल्डर में, काम के एमसीसी/एमएनसी के आधार पर, काम की एक्सएमएल फ़ाइलों की पहचान करें. इस फ़ाइल में, एक्सएमएल फ़ॉर्मैट में कैरियर कॉन्फ़िगरेशन ऑब्जेक्ट शामिल होता है. एट्रिब्यूट के नाम, कैरियर कॉन्फ़िगरेशन मैनेजर में कुंजियों के तौर पर तय किए जाते हैं. साथ ही, वैल्यू के टाइप (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 चला सकते हैं.