Android ऐप्लिकेशन बनाना

Android बनाने के लिए, इस पेज पर दिए गए निर्देशों का पालन करें.

बिल्ड एनवायरमेंट सेट अप करना

बिल्ड एनवायरमेंट सेट अप करने के लिए, अपनी वर्किंग डायरेक्ट्री में जाकर envsetup.sh स्क्रिप्ट को सोर्स करें:

source build/envsetup.sh

यह स्क्रिप्ट कई ऐसे कमांड इंपोर्ट करती है जिनकी मदद से, Android के सोर्स कोड के साथ काम किया जा सकता है. इनमें इस पेज पर इस्तेमाल किए गए कमांड भी शामिल हैं. स्क्रिप्ट का सोर्स देखने के लिए, देखें platform/build/envsetup.sh. बिल्ट-इन मदद देखने के लिए, hmm टाइप करें.

कोई टारगेट चुनना

Android बनाने से पहले, आपको कोई टारगेट चुनना होगा. टारगेट से पता चलता है कि आपको किस प्लैटफ़ॉर्म के लिए बिल्ड करना है. बिल्ड करने के लिए अपना टारगेट चुनने के लिए, lunch कमांड का इस्तेमाल करें. इसके बाद, टारगेट को दिखाने वाली स्ट्रिंग का इस्तेमाल करें. उदाहरण के लिए:

lunch aosp_cf_x86_64_only_phone-aosp_current-userdebug

आपको अपने टारगेट और बिल्ड एनवायरमेंट की खास जानकारी दिखेगी:

============================================
PLATFORM_VERSION_CODENAME=Baklava
PLATFORM_VERSION=Baklava
TARGET_PRODUCT=aosp_cf_x86_64_only_phone
TARGET_BUILD_VARIANT=userdebug
TARGET_ARCH=x86_64
TARGET_ARCH_VARIANT=silvermont
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.10.11-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=BP1A.250305.020
OUT_DIR=out
============================================

टारगेट को दिखाने वाली स्ट्रिंग का फ़ॉर्मैट यह होता है:

lunch product_name-release_config-build_variant

इस स्ट्रिंग के कॉम्पोनेंट ये हैं:

• product_name उस प्रॉडक्ट का नाम होता है जिसे आपको बिल्ड करना है. जैसे, aosp_cf_x86_64_only_phone या aosp_husky. आपके डिवाइस के लिए, product_name का फ़ॉर्मैट अलग हो सकता है. हालांकि, Google अपने डिवाइसों के लिए जिस फ़ॉर्मैट का इस्तेमाल करता है उसमें ये कॉम्पोनेंट होते हैं:

  • aosp का मतलब है Android ओपन सोर्स प्रोजेक्ट.
  • ज़रूरी नहीं कि cf शामिल हो. हालांकि, अगर टारगेट को Cuttlefish एम्युलेटर में चलाना है, तो cf शामिल किया जाता है.
  • आर्किटेक्चर और हार्डवेयर का कोडनेम. जैसे, x86_64_only_phone या husky. यह Pixel 8 Pro का कोडनेम है. Google के डिवाइसों के कोडनेम की सूची के लिए, डिवाइस के कोडनेम देखें.

• release_config को रिलीज़ कॉन्फ़िगरेशन पर सेट किया जाता है. जैसे, डेवलपमेंट रिलीज़ कॉन्फ़िगरेशन, जिसे aosp_current कहा जाता है. रिलीज़ कॉन्फ़िगरेशन से, उन सुविधाओं और कोड की पहचान होती है जो सुविधा लॉन्च फ़्लैग के पीछे होते हैं. साथ ही, यह भी पता चलता है कि किसी बिल्ड के लिए उन्हें चालू किया गया है या बंद. रिलीज़ कॉन्फ़िगरेशन के बारे में ज़्यादा जानने के लिए, सुविधा फ़्लैग लॉन्च की वैल्यू सेट करना देखें.

• स्ट्रिंग का build_variant हिस्सा, यहां दी गई टेबल में मौजूद तीन वैल्यू में से कोई एक हो सकता है:

  build_variant	ब्यौरा
  user	इस बिल्ड वैरिएंट से, सुरक्षा के लिए सीमित ऐक्सेस मिलता है. यह प्रोडक्शन के लिए सही है.
  userdebug	इस बिल्ड वैरिएंट से, डिवाइस के डेवलपर को डेवलपमेंट के दौरान रिलीज़ की परफ़ॉर्मेंस और पावर को समझने में मदद मिलती है. userdebug बिल्ड के साथ डेवलपमेंट करते समय, userdebug के लिए दिशा-निर्देशों का पालन करें.
  eng	इस बिल्ड का वैरिएंट, बिल्ड प्रोसेस में लगने वाला समय कम करता है. यह रोज़ाना के डेवलपमेंट एनवायरमेंट के लिए सबसे सही है. ऐसे एनवायरमेंट में, परफ़ॉर्मेंस और पावर की अहमियत कम होती है.

अगर lunch को बिना किसी आर्ग्युमेंट के चलाया जाता है, तो lunch सामान्य टारगेट की सूची दिखाता है. कस्टम टारगेट स्ट्रिंग बनाने के लिए, टारगेट स्ट्रिंग एलिमेंट को हार्डवेयर कोडनेम के साथ मिलाएं. कोडनेम की सूची के लिए, डिवाइस के कोडनेम देखें.

मौजूदा टारगेट देखना

मौजूदा lunch सेटिंग देखने के लिए, यह कमांड चलाएं:

$ echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"

कोड बिल्ड करना

अपना टारगेट बिल्ड करने के लिए, यह कमांड चलाएं. आपके वर्कस्टेशन की खास जानकारी के आधार पर, पहले बिल्ड में एक घंटे से भी कम समय लग सकता है. हालांकि, इसमें कुछ घंटे भी लग सकते हैं. इसके बाद के बिल्ड में काफ़ी कम समय लगता है.

m

आपके बिल्ड का आउटपुट, $OUT_DIR में दिखता है. अगर अलग-अलग टारगेट बिल्ड किए जाते हैं, तो हर टारगेट बिल्ड $OUT_DIR में दिखता है.

m कमांड, ट्री के सबसे ऊपर से बिल्ड करता है. इसलिए, सबडायरेक्ट्री में जाकर भी m चलाया जा सकता है. अगर आपने TOP एनवायरमेंट वैरिएबल सेट किया है, तो m कमांड इसका इस्तेमाल करता है. अगर TOP सेट नहीं है, तो m कमांड, मौजूदा डायरेक्ट्री से ट्री को ढूंढता है, ताकि ट्री का सबसे ऊपरी हिस्सा मिल सके.

m कमांड, -jN आर्ग्युमेंट के साथ, एक साथ कई टास्क पूरे कर सकता है. अगर -j आर्ग्युमेंट नहीं दिया जाता है, तो बिल्ड सिस्टम अपने-आप एक साथ कई टास्क पूरे करने की संख्या चुन लेता है. यह संख्या, आपके सिस्टम के लिए ऑप्टिमाइज़ की गई होती है.

m कमांड लाइन में मॉड्यूल के नाम डालकर, पूरे डिवाइस की इमेज के बजाय खास मॉड्यूल बिल्ड किए जा सकते हैं. इसके अलावा, m कमांड कुछ स्यूडो टारगेट उपलब्ध कराता है. इन्हें गोल कहा जाता है. उदाहरण के लिए, m nothing से कुछ भी बिल्ड नहीं होता. हालांकि, यह बिल्ड स्ट्रक्चर को पार्स और मान्य करता है. मान्य गोल की सूची देखने के लिए, m help टाइप करें.

बिल्ड की गड़बड़ियां ठीक करना

इस सेक्शन में, बिल्ड की गड़बड़ियां ठीक करने के निर्देश दिए गए हैं.

फ़ाइल सिस्टम की रीड-ओनली गड़बड़ियां (Android 17 और इसके बाद के वर्शन)

बिल्ड के दौरान, AOSP सोर्स ट्री रीड-ओनली होता है. अगर आपके बिल्ड में, प्रॉडक्ट कॉन्फ़िगरेशन या बिल्ड के किसी अन्य हिस्से के दौरान, सोर्स ट्री में बदलाव करने की कोशिश की जाती है, तो बिल्ड में गड़बड़ी आ सकती है. साथ ही, फ़ाइल सिस्टम की रीड-ओनली गड़बड़ियां दिख सकती हैं. सोर्स ट्री को अस्थायी तौर पर रीड-राइट में बदलने के लिए, इन विकल्पों का इस्तेमाल किया जा सकता है:

• बिल्ड के दौरान, पूरे सोर्स ट्री को रीड-राइट में बदलने के लिए, बिल्ड एनवायरमेंट में BUILD_BROKEN_SRC_DIR_IS_WRITABLE=true जोड़ें.

• बिल्ड के दौरान, ट्री के किसी हिस्से को रीड-राइट में बदलने के लिए, BUILD_BROKEN_SRC_DIR_RW_ALLOWLIST="path1, path2, ..." का इस्तेमाल करें. पाथ, उन डायरेक्ट्री के पाथ होने चाहिए जिनमें राइट की अनुमति दी जानी चाहिए. ये पाथ, वर्कस्पेस के सबसे ऊपरी हिस्से के हिसाब से होने चाहिए.

Java का गलत वर्शन (Android 8.0 और इससे पुराने वर्शन)

अगर Android 8.0 (एपीआई लेवल 26) और इससे पुराने वर्शन के लिए बिल्ड किया जा रहा है, तो Java के वर्शन में कोई समस्या आने पर, m बंद हो सकता है. उदाहरण के लिए, आपको यह मैसेज मिल सकता है:

************************************************************
You are attempting to build with the incorrect version of java.

Your version is: WRONG_VERSION.
The correct version is: RIGHT_VERSION.

Please follow the machine setup instructions at
https://source.android.com/source/initializing.html
************************************************************

इसकी ये वजहें और समाधान हो सकते हैं:

• सही JDK इंस्टॉल नहीं है. ज़्यादा जानकारी के लिए, AOSP डेवलपमेंट (2.3-8.0) के लिए सेट अप करना देखें.
• आपके पाथ में, पहले से इंस्टॉल किया गया कोई दूसरा JDK दिख रहा है. अपने पाथ की शुरुआत में सही JDK जोड़ें या समस्या पैदा करने वाले JDK को हटाएं.