साल 2026 से, हम दूसरी और चौथी तिमाही में AOSP के लिए सोर्स कोड पब्लिश करेंगे. ऐसा इसलिए किया जाएगा, ताकि हम अपने ट्रंक स्टेबल डेवलपमेंट मॉडल के साथ काम कर सकें और यह पक्का कर सकें कि प्लैटफ़ॉर्म, पूरे सिस्टम के लिए स्थिर बना रहे. AOSP बनाने और उसमें योगदान देने के लिए, android-latest-release का इस्तेमाल करें. android-latest-release मेनिफ़ेस्ट ब्रांच, हमेशा AOSP पर पुश की गई सबसे नई रिलीज़ का रेफ़रंस देगी. ज़्यादा जानकारी के लिए, AOSP में हुए बदलाव देखें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

SDV को डीबग करना

इस गाइड में, एसडीवी प्लैटफ़ॉर्म पर चलने वाली सेवाओं और ऐप्लिकेशन को डीबग करने के लिए ज़रूरी टूल और तकनीकों के बारे में खास जानकारी दी गई है.

डिवाइस से कनेक्ट करें

डिवाइस से कनेक्ट करने और उससे इंटरैक्ट करने के लिए, मुख्य टूल Android डीबग ब्रिज (adb) है. पुष्टि करें कि adb आपके सिस्टम के पाथ में है.

नेटवर्क का इस्तेमाल करके कनेक्ट करना

अगर डिवाइस उसी नेटवर्क पर है और आपको उसका आईपी पता पता है, तो ईथरनेट से कनेक्ट किया जा सकता है. हमारा सिस्टम, adb के लिए सिर्फ़ इंटरनेट कनेक्शन का इस्तेमाल करता है:

# Connect to the device using its IP address and default port
adb connect <device_ip_address>:5555

एक से ज़्यादा डिवाइसों से कनेक्ट करना

एक ही वर्कस्टेशन से कई डिवाइसों को मैनेज करने के लिए, उन्हें अलग-अलग आईपी पतों से कनेक्ट किया जा सकता है. अगर एक ही होस्ट पर कई वीएम चलाए जा रहे हैं, तो आपको हर डिवाइस के लिए अलग-अलग पोर्ट असाइन करने होंगे. इसके लिए, हर SDV डिवाइस पर adb डीमन को कॉन्फ़िगर करना होगा, ताकि वह किसी यूनीक पोर्ट पर सिग्नल पा सके. उदाहरण के लिए, पहले डिवाइस के लिए 5555 और दूसरे डिवाइस के लिए 5556. होस्ट को उन पोर्ट को अलग-अलग मेहमानों को फ़ॉरवर्ड करने के लिए भी कॉन्फ़िगर किया जा सकता है:

# Connect to the first device
adb connect <device_1_ip_address>:5555

# Connect to a second device
adb connect <device_2_ip_address>:5555

# Connect to a second VM on first device on different port
adb connect <device_1_ip_address>:5556

# List all connected devices to verify
adb devices

इसके बाद, adb कमांड चलाते समय, किसी खास डिवाइस को टारगेट किया जा सकता है. इसके लिए, -s फ़्लैग का इस्तेमाल करके, डिवाइस का पूरा पता (ip:port) डालें:

# Run a shell command on the second VM on first device in the above example
adb -s <device_1_ip_address>:5556 shell

लॉग देखें

जब कोई सेवा काम न करे या उम्मीद के मुताबिक काम न करे, तो सबसे पहले लॉग देखें.

Logcat (Android लॉग) का इस्तेमाल करना

logcat, सिस्टम की सेवाओं, एजेंट, और सेवा बंडल के लॉग दिखाता है:

# View all logs in real-time
adb logcat

# Filter logs by a specific tag (e.g., the name of your service)
adb logcat -s MyServiceTag

# Filter logs by priority (V: Verbose, D: Debug, I: Info, W: Warn, E: Error, F: Fatal)
# This shows only Error and Fatal messages for a specific tag
adb logcat MyServiceTag:E *:S

# Clear old logs before viewing new ones
adb logcat -c && adb logcat

# Show all logs and return
adb logcat -d

# Color logs by level
adb logcat -v color

# Show timestamps as time since boot
adb logcat -v monotonic

dmesg (कर्नेल लॉग) का इस्तेमाल करना

dmesg, Linux कर्नेल के लॉग दिखाता है. यह इन समस्याओं को डीबग करने के लिए ज़रूरी है:

हार्डवेयर और ड्राइवर से जुड़ी समस्याएं
कर्नेल पैनिक
SELinux की अस्वीकार की गई कार्रवाइयां (avc: denied) - ये logcat में भी दिखती हैं

# View all kernel messages
adb shell dmesg

# Follow kernel messages in real-time
adb shell dmesg -w

Cuttlefish पर लॉग ऐक्सेस करना

Cuttlefish वर्चुअल डिवाइस पर, होस्ट मशीन के फ़ाइल सिस्टम से लॉग फ़ाइलों को सीधे ऐक्सेस किया जा सकता है. यह सुविधा खास तौर पर तब काम आती है, जब adb उपलब्ध न हो. Cuttlefish को चालू करने पर, यह डीबग करने के सभी पाथ दिखाता है. साथ ही, चल रहे सभी इंस्टेंस के लिए, cvd fleet का इस्तेमाल करके भी उन्हें देखा जा सकता है.

Logcat (Android लॉग): cuttlefish/instances/cvd-1/logs/logcat
कर्नेल लॉग: cuttlefish/instances/cvd-1/logs/kernel.log
Cuttlefish लॉन्चर लॉग: cuttlefish/instances/cvd-1/logs/launcher.log (Cuttlefish एनवायरमेंट को डीबग करने के लिए काम का है)

इन फ़ाइलों को रीयल टाइम में देखने के लिए, cat, less या tail -f जैसे स्टैंडर्ड कमांड-लाइन टूल इस्तेमाल किए जा सकते हैं.

शेल और फ़ाइल सिस्टम के साथ इंटरैक्ट करना

डिवाइस पर सीधे तौर पर कमांड चलाने, प्रोसेस की स्थिति देखने, और फ़ाइल सिस्टम को नेविगेट करने के लिए, शेल ऐक्सेस पाएं:

# Open an interactive shell on the device
adb shell

# From within the shell, you can check running processes
ps -A

# Or check the status of a specific service managed by init
getprop init.svc.<service_name>

फ़ाइल सिस्टम से जुड़ी कार्रवाइयां करना

होस्ट मशीन और डिवाइस के बीच फ़ाइलें ट्रांसफ़र करने के लिए, adb push और adb pull का इस्तेमाल करें. इसका इस्तेमाल, टेस्ट स्क्रिप्ट डिप्लॉय करने, कॉन्फ़िगरेशन अपडेट करने या क्रैश डंप को वापस पाने के लिए करें:

# Push a file from your computer to the device
adb push my_local_file.txt /data/local/tmp/

# Pull a file from the device to your computer
adb pull /data/tombstones/tombstone_00 .

ऐप्लिकेशन डीबग करना (C++/Rust)

ऐप्लिकेशन को ऑनलाइन या ऑफ़लाइन डीबग किया जा सकता है.

लाइव डीबगिंग के लिए lldb का इस्तेमाल करना

lldb का इस्तेमाल करके, रीयल-टाइम में किसी सेवा को डीबग करने के लिए, यह तरीका अपनाएं. Android Studio for Platform से डीबगर अटैच करने के लिए, डीबग और टेस्ट करें और प्लैटफ़ॉर्म कोड को डीबग करें देखें:

रूट अनुमतियों के साथ adb को रीस्टार्ट करें (पोर्ट फ़ॉरवर्डिंग के लिए ज़रूरी है):
```
adb root
```
अगर किसी बाइनरी में डीबग करने के सिंबल हैं, तो out/target/product/[SDV_FLAVOR]/symbols/[PARTITION]/bin/[EXECUTABLE] से अनस्ट्रिप्ड वर्शन पुश करें. उदाहरण के लिए, system_ext और sdv_core_cf से rpcagent अपलोड करने के लिए, यह कमांड चलाएं:
```
adb push out/target/product/sdv_core_cf/symbols/system_ext/bin/rpcagent /data/local/tmp
```
lldbclient.py सुविधा स्क्रिप्ट का इस्तेमाल करके, LLDB क्लाइंट से कनेक्ट करें:
```
# Run and connect a binary on device, run on host:
lldbclient.py -r /data/local/tmp/rpcagent

# Connect to an existing process with PID 2759
lldbclient.py -p 2759
```
यह स्क्रिप्ट, lldb को रिमोटली कनेक्ट करती है. सभी उपलब्ध फ़्लैग के लिए, lldbclient.py --help चलाएं.

क्रैश डंप (टॉम्बस्टोन) का विश्लेषण करना

जब कोई सेवा क्रैश होती है, तो /data/tombstones/ में एक टॉम्बस्टोन फ़ाइल जनरेट होती है. इस फ़ाइल में स्टैक ट्रेस, मेमोरी मैप, और अन्य अहम जानकारी होती है.

टूंबस्टोन फ़ाइल को पुल करें. इसके बाद, सिंबल की जानकारी देने वाले टूल (जैसे, lldb या कोई खास स्क्रिप्ट) का इस्तेमाल करके, बाइनरी के अनस्ट्रिप्ड वर्शन के साथ उसका विश्लेषण करें.

परफ़ॉर्मेंस का विश्लेषण करना

SDV में, परफ़ॉर्मेंस मेज़रमेंट के लिए कई टूल इस्तेमाल किए जा सकते हैं.

सीपीयू और मेमोरी के इस्तेमाल की जानकारी देखना

top: इससे सीपीयू के इस्तेमाल के हिसाब से, चल रही प्रोसेस की रीयल-टाइम जानकारी मिलती है.
```
adb shell top -m 10  # Show top 10 processes
```
procrank: इससे किसी खास प्रोसेस या पूरे सिस्टम के लिए, मेमोरी के इस्तेमाल की पूरी जानकारी मिलती है.
```
adb shell procrank
```

सेवा की स्थिति जानने के लिए dumpsys का इस्तेमाल करना

dumpsys, Android सिस्टम की किसी भी सेवा की अंदरूनी स्थिति के बारे में क्वेरी करने के लिए एक बेहतरीन टूल है.

# List all available services
adb shell dumpsys -l

# Dump the state of a specific service or agent
adb shell dumpsys <service_name>

परफ़ॉर्मेंस का विश्लेषण करने के लिए, torq का इस्तेमाल करना

torq एक कमांड-लाइन टूल है. इससे Android पर प्रोफ़ाइलिंग और ट्रेसिंग के टास्क आसान हो जाते हैं. इसकी मदद से, सिस्टम की परफ़ॉर्मेंस का विश्लेषण करते समय Simpleperf, Perfetto, और अन्य सामान्य टास्क चलाए जा सकते हैं.

ट्रेस करने के लिए Perfetto का इस्तेमाल करना

Perfetto, Android पर पूरे सिस्टम को ट्रेस करने के लिए स्टैंडर्ड टूल है. Perfetto की मदद से, सिस्टम इवेंट, ऐप्लिकेशन-लेवल के ट्रेस पॉइंट, और परफ़ॉर्मेंस काउंटर रिकॉर्ड किए जा सकते हैं. साथ ही, उन्हें टाइमलाइन पर विज़ुअलाइज़ किया जा सकता है.

अहम चरण:

अपने C++ या Rust कोड में ट्रेस पॉइंट जोड़ें:
- C++: TRACE_EVENT मैक्रो के साथ Perfetto SDK टूल का इस्तेमाल करें.
- Rust: tracing क्रेट का इस्तेमाल करें. यह Perfetto के साथ काम करने वाले ATrace इवेंट जनरेट करता है.
डेटा सोर्स (उदाहरण के लिए, ftrace, track_event), कैटगरी, और टैग तय करने के लिए, textproto कॉन्फ़िगरेशन फ़ाइल बनाएं.
डिवाइस से ट्रेस कैप्चर करने के लिए, अपनी कॉन्फ़िगरेशन फ़ाइल के साथ record_android_trace स्क्रिप्ट (external/perfetto/tools/record_android_trace) का इस्तेमाल करें.
सिस्टम के व्यवहार का विश्लेषण करने, रुकावटों की पहचान करने, और सेवा के इंटरैक्शन को समझने के लिए, जनरेट की गई ट्रेस फ़ाइल को Perfetto वेब यूज़र इंटरफ़ेस (यूआई) में खोलें.

इंस्ट्रुमेंटेशन, कॉन्फ़िगरेशन, और कलेक्शन के बारे में ज़्यादा जानकारी पाने के लिए, सिस्टम की परफ़ॉर्मेंस के बारे में अहम जानकारी पाने के लिए ट्रेसिंग का इस्तेमाल करना लेख पढ़ें.

प्रोफ़ाइल बनाने के लिए Simpleperf का इस्तेमाल करना

Simpleperf, कमांड-लाइन टूल है. इसका इस्तेमाल Android पर परफ़ॉर्मेंस प्रोफ़ाइलिंग के लिए किया जाता है. यह Linux perf की तरह काम करता है.

इस्तेमाल के सामान्य उदाहरण:

सीपीयू प्रोफ़ाइलिंग: सबसे ज़्यादा सीपीयू समय लेने वाले फ़ंक्शन की पहचान करें.
ऑफ़-सीपीयू विश्लेषण: इससे यह विश्लेषण किया जा सकता है कि थ्रेड क्यों स्लीप मोड में हैं या ब्लॉक हैं.
हार्डवेयर काउंटर: हार्डवेयर की परफ़ॉर्मेंस के काउंटर ऐक्सेस करना.

निर्देशों के उदाहरण:

# Go to simpleperf scripts
cd system/extras/simpleperf/scripts

# Profile system for 20 seconds and record call graph
./app_profiler.py --system_wide -r "--call-graph fp --duration 20"

# Record a profile for a specific process (PID 1)
./app_profiler.py --pid 1 -r "--call-graph fp --duration 5"

# Pull the profile data
adb pull /data/local/tmp/perf.data .

# Generate a report with symbol resolution
./report_html.py --add_source_code --source_dirs $ANDROID_BUILD_TOP --add_disassembly -o report.html

Simpleperf में कई और इवेंट और विकल्प उपलब्ध हैं. ज़्यादा जानकारी के लिए, Simpleperf गाइड देखें.

SELinux की ओर से नामंज़ूर की गई कार्रवाइयां

समस्या का ब्यौरा: आपकी सेवा शुरू नहीं हो पा रही है, किसी फ़ाइल को ऐक्सेस नहीं कर पा रही है या किसी सुविधा का इस्तेमाल नहीं कर पा रही है. साथ ही, आपको dmesg या logcat में avc: denied मैसेज दिख रहा है.

[ 123.456] avc: denied { read } for pid=789 comm="my_service" name="some_file" dev="sda1" ino=123 scontext=u:r:my_service_t:s0 tcontext=u:object_r:some_file_t:s0 tclass=file permissive=0

क्विक डीबग (सिर्फ़ डेवलपमेंट के लिए)

SELinux को लागू करने की सुविधा को कुछ समय के लिए बंद करके देखें कि समस्या हल हुई या नहीं. इससे पुष्टि होती है कि समस्या, SELinux नीति के नियम के मौजूद न होने की वजह से है.

# Disabling SELinux requires root permission
adb root

# Set SELinux to permissive mode
adb shell setenforce 0

# Check the current mode (should return "Permissive")
adb shell getenforce

ठीक करें: अनुमति न मिलने के मैसेज पर, Android सोर्स ट्री से audit2allow टूल का इस्तेमाल करें. इससे सही .te नीति नियम जनरेट होता है, ताकि उसे आपके डिवाइस के SELinux कॉन्फ़िगरेशन में जोड़ा जा सके.