← Back to Blog

Android स्टूडियो और ग्रेडल में प्रॉक्सी सेटअप कैसे करें: gradle.properties और SDK प्रबंधक

हम समझते हैं कि gradle.properties में प्रॉक्सी को सही तरीके से कैसे लिखा जाए, SDK प्रबंधक और Android स्टूडियो को कैसे सेटअप किया जाए, और ग्रेडल सिंक्रनाइज़ेशन की सबसे सामान्य त्रुटियों को कैसे हल किया जाए।

📅November 13, 2026

यदि Android Studio Gradle सिंक्रनाइज़ेशन के चरण पर "लटक" जाती है, SDK प्रबंधक घटकों को लोड नहीं करता है, और Maven Central से निर्भरताएँ डाउनलोड नहीं होती हैं — 80% मामलों में समस्या कोड में नहीं होती, बल्कि नेटवर्क वातावरण में होती है। कॉर्पोरेट फ़ायरवॉल, VPN, रिपॉजिटरी के IP को ब्लॉक करना या बस इंटरनेट तक सीधी पहुँच का अभाव — इन सभी समस्याओं का समाधान प्रॉक्सी को तीन स्तरों पर सही तरीके से सेटअप करना है: IDE, Gradle और SDK प्रबंधक। चलिए समझते हैं कि प्रॉक्सी को सही तरीके से और बिना किसी अतिरिक्त सिंक्रनाइज़ेशन त्रुटियों के कैसे लिखा जाए।

Android डेवलपर को प्रॉक्सी की आवश्यकता क्यों है

अक्सर Android Studio के साथ प्रॉक्सी का उपयोग कई परिदृश्यों में किया जाता है। पहला — कॉर्पोरेट नेटवर्क, जहाँ इंटरनेट तक सीधी पहुँच बंद होती है, और सभी ट्रैफ़िक, जिसमें google(), mavenCentral() और dl.google.com के लिए अनुरोध शामिल हैं, को कंपनी के प्रॉक्सी सर्वर के माध्यम से जाना चाहिए। दूसरा — क्षेत्रीय प्रतिबंधों को बायपास करना: कुछ SDK घटक, Google Play Services API या तृतीय-पक्ष रिपॉजिटरी सीधे कुछ देशों से उपलब्ध नहीं हैं, और डेवलपर को ट्रैफ़िक को किसी अन्य भू-स्थान के IP के माध्यम से रूट करना पड़ता है।

तीसरा परिदृश्य — ऐप के भू-निर्भर कार्यक्षमता का परीक्षण करना। यदि ऐप उपयोगकर्ता के देश के आधार पर अलग-अलग सामग्री, कीमतें या विज्ञापन दिखाता है, तो QA इंजीनियरों और डेवलपर्स को निर्माण और डिबगिंग के चरण में आवश्यक क्षेत्र से अनुरोधों का अनुकरण करना होगा, रिलीज़ का इंतज़ार किए बिना। चौथा — CI/CD रनरों के साथ काम करना, जो भौतिक रूप से डेटा केंद्रों में स्थित होते हैं जिनमें कुछ सेवाओं तक सीमित पहुँच होती है, और प्रॉक्सी एकमात्र तरीका बन जाता है "ज़रूरी" रिपॉजिटरी या API तक पहुँचने का।

इन सभी मामलों में तर्क एक ही है: Gradle, SDK प्रबंधक और स्वयं IDE को प्रॉक्सी सर्वर का पता, पोर्ट और, यदि आवश्यक हो, क्रेडेंशियल्स जानने चाहिए, अन्यथा प्रोजेक्ट की सिंक्रनाइज़ेशन टाइमआउट या कनेक्शन त्रुटियों के साथ विफल हो जाएगी।

डेवलपमेंट के लिए कौन सा प्रॉक्सी प्रकार चुनें

विकास और परीक्षण के लिए, गुमनामी से अधिक महत्वपूर्ण है कनेक्शन की स्थिरता और लंबे डाउनलोड के दौरान टूटने की कम दर (उदाहरण के लिए, Android SDK प्लेटफ़ॉर्म उपकरण सैकड़ों मेगाबाइट का आकार रखते हैं)। नीचे Android डेवलपर के कार्यों के लिए प्रॉक्सी प्रकारों की तुलना की गई है।

प्रॉक्सी प्रकार कब उपयोग करें विशेषताएँ
डेटा केंद्र प्रॉक्सी SDK डाउनलोड, Gradle सिंक्रनाइज़ेशन, CI/CD उच्च गति, कम कीमत, बड़े डाउनलोड के लिए स्थिर
रिहायशी प्रॉक्सी भू-निर्भर API और सामग्री का परीक्षण वास्तविक उपयोगकर्ताओं के IP, सेवाओं द्वारा कम ब्लॉक किए जाते हैं
मोबाइल प्रॉक्सी विशिष्ट देश से मोबाइल API और पुश सूचनाओं का परीक्षण संचार प्रदाताओं के IP, वास्तविक मोबाइल ट्रैफ़िक के निकटतम

Gradle की शुद्ध सिंक्रनाइज़ेशन और निर्भरताओं को डाउनलोड करने के लिए, डेटा केंद्र प्रॉक्सी लेना अधिक समझदारी है — ये बिना किसी अतिरिक्त देरी के स्थिर उच्च गति प्रदान करते हैं। यदि कार्य यह है कि ऐप का बैकएंड दूसरे देश के उपयोगकर्ता को कैसे प्रतिक्रिया देता है, तो रिहायशी या मोबाइल IP अधिक उपयुक्त होंगे।

gradle.properties में प्रॉक्सी सेटअप

फ़ाइल gradle.properties वह मुख्य स्थान है जहाँ Gradle HTTP और HTTPS कनेक्शनों के लिए प्रॉक्सी सेटिंग्स खोजता है। फ़ाइल प्रोजेक्ट की जड़ में हो सकती है (यह केवल उसके लिए कार्य करती है) या वैश्विक निर्देशिका ~/.gradle/gradle.properties में (यह मशीन पर सभी प्रोजेक्ट्स के लिए कार्य करती है)। प्रॉक्सी के माध्यम से निरंतर काम करने के लिए, दूसरा विकल्प अनुशंसित है।

# ~/.gradle/gradle.properties

systemProp.http.proxyHost=proxy.example.com
systemProp.http.proxyPort=8080
systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080

# वैकल्पिक — अपवाद जो सीधे प्रॉक्सी को बायपास करते हैं
systemProp.http.nonProxyHosts=localhost|127.0.0.1|*.internal.corp

फ़ाइल को सहेजने के बाद, कृपया File → Sync Project with Gradle Files या टूलबार पर "हाथी" आइकन पर क्लिक करें। यदि IDE ने स्वचालित रूप से परिवर्तनों को नहीं लिया, तो Android Studio को पुनः प्रारंभ करें — कभी-कभी प्रॉक्सी सेटिंग्स का कैश Gradle Daemon प्रक्रिया के पुनः प्रारंभ होने तक बना रहता है।

एक महत्वपूर्ण बिंदु: systemProp.* पैरामीटर वास्तव में उस JVM स्तर पर कार्य करते हैं, जिसमें Gradle चल रहा है, इसलिए ये न केवल निर्भरताओं को डाउनलोड करने पर प्रभाव डालते हैं, बल्कि बिल्ड स्क्रिप्ट के भीतर किसी भी नेटवर्क अनुरोध पर भी प्रभाव डालते हैं (उदाहरण के लिए, यदि आपकी एक कस्टम Gradle कार्य है जो बाहरी API को कॉल करती है)।

Android Studio में प्रॉक्सी सेटअप

Gradle के अलावा, IDE की अपनी नेटवर्क सेटिंग्स हैं — ये प्लगइन्स, IDE अपडेट, लाइसेंस की जांच और Google से सुझाव जैसी कुछ सुविधाओं के लिए आवश्यक हैं। इन्हें File → Settings → Appearance & Behavior → System Settings → HTTP Proxy के माध्यम से खोला जा सकता है (macOS पर — Android Studio → Preferences)।

खुले हुए विंडो में Manual proxy configuration चुनें, होस्ट और पोर्ट निर्दिष्ट करें, यदि आवश्यक हो तो Proxy authentication को चिह्नित करें और लॉगिन और पासवर्ड दर्ज करें। वहाँ एक उपयोगी बटन Check connection भी है — एक परीक्षण URL (जैसे, https://dl.google.com) दर्ज करें और इसे क्लिक करें, यह सुनिश्चित करने के लिए कि कनेक्शन सही तरीके से हो रहा है, इससे पहले कि आप पूर्ण प्रोजेक्ट सिंक्रनाइज़ेशन शुरू करें।

महत्वपूर्ण अंतर को समझना

सेटिंग्स में HTTP प्रॉक्सी IDE पर प्रभाव डालती हैं (प्लगइन्स, अपडेट), जबकि gradle.properties में पैरामीटर Gradle बिल्ड प्रक्रिया पर प्रभाव डालते हैं। ये दो स्वतंत्र तंत्र हैं, और प्रॉक्सी के पीछे पूरी तरह से काम करने के लिए आमतौर पर दोनों को सेटअप करना आवश्यक होता है।

SDK प्रबंधक के लिए प्रॉक्सी

SDK प्रबंधक एक अलग घटक है, जो Android प्लेटफ़ॉर्म, बिल्ड-टूल्स, एमुलेटर्स और सिस्टम इमेज को डाउनलोड करता है। इसकी अपनी प्रॉक्सी कॉन्फ़िगरेशन है, जो ऐतिहासिक रूप से IDE की उसी सिस्टम सेटिंग्स के माध्यम से निर्धारित होती है, लेकिन जब स्टैंडअलोन sdkmanager (कमांड लाइन से CLI उपयोगिता) के माध्यम से काम करते हैं, तो पैरामीटर को स्पष्ट रूप से JVM फ्लैग के माध्यम से पास करना आवश्यक होता है।

sdkmanager --proxy=http \
  --proxy_host=proxy.example.com \
  --proxy_port=8080 \
  --list

यदि sdkmanager स्क्रिप्ट के माध्यम से चलाया जाता है, तो प्रॉक्सी को सीधे JAVA_OPTS पर्यावरण चर में निर्दिष्ट किया जा सकता है, जिसे निष्पादन फ़ाइल पढ़ती है:

export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 \
-Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=8080"

एक सामान्य त्रुटि — Android Studio में प्रॉक्सी को सेट करना, लेकिन स्टैंडअलोन उपयोगिताओं जैसे sdkmanager या avdmanager के बारे में भूल जाना, जो अलग Java प्रक्रिया के रूप में चलती हैं और स्वचालित रूप से IDE सेटिंग्स को विरासत में नहीं लेती हैं।

gradlew और पर्यावरण चर के लिए प्रॉक्सी

यदि आप टर्मिनल से ./gradlew के माध्यम से प्रोजेक्ट का निर्माण कर रहे हैं, IDE को बायपास करते हुए (उदाहरण के लिए, CI/CD में या बस आदत से), तो प्रॉक्सी को सीधे कमांड में पास किया जा सकता है बिना gradle.properties को बदले:

./gradlew build \
  -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 \
  -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=8080

निरंतर उपयोग के लिए, GRADLE_OPTS पर्यावरण चर को शेल प्रोफ़ाइल (.bashrc, .zshrc Linux/macOS के लिए या Windows में पर्यावरण चर) में सेट करना अधिक सुविधाजनक है:

export GRADLE_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=8080 -Dhttps.proxyHost=proxy.example.com -Dhttps.proxyPort=8080"

यह GitHub Actions, GitLab CI या Jenkins में CI रनरों में विशेष रूप से उपयोगी है, जहाँ पर्यावरण चर एक बार नौकरी के स्तर पर सेट किए जाते हैं और सभी बाद के निर्माण चरणों द्वारा स्वचालित रूप से उठाए जाते हैं, बिना प्रोजेक्ट फ़ाइलों को संपादित किए।

सामान्य सिंक्रनाइज़ेशन त्रुटियाँ और उनका समाधान

हम उन सबसे सामान्य त्रुटियों पर चर्चा करेंगे, जिनका सामना डेवलपर्स प्रॉक्सी सेट करते समय करते हैं, और उन्हें हल करने के लिए विशिष्ट कदम।

त्रुटि कारण समाधान
Connection timed out प्रॉक्सी निर्दिष्ट नहीं है या उपलब्ध नहीं है gradle.properties में host/port की जाँच करें, curl के माध्यम से प्रॉक्सी की उपलब्धता का परीक्षण करें
407 Proxy Authentication Required लॉगिन/पासवर्ड प्रदान नहीं किए गए systemProp.http.proxyUser और systemProp.http.proxyPassword जोड़ें
Unable to resolve host DNS-रेज़ॉल्विंग प्रॉक्सी के माध्यम से नहीं हो रही है SOCKS5 के लिए http के बजाय socksProxyHost का उपयोग करें
Could not GET 'https://dl.google.com/...' Gradle सेटिंग्स निर्धारित हैं, लेकिन IDE में नहीं (या इसके विपरीत) दोनों स्थानों पर सेटिंग्स को सिंक्रनाइज़ करें: Settings → HTTP Proxy और gradle.properties
SSL handshake failed प्रॉक्सी SSL को इंटरसेप्ट कर रहा है (कॉर्पोरेट MITM) प्रॉक्सी का रूट प्रमाणपत्र आपकी JDK के cacerts में आयात करें

यदि त्रुटि विशेष रूप से कुछ Maven आर्टिफैक्ट्स (जैसे, androidx.* पुस्तकालयों) को डाउनलोड करते समय होती है, तो Gradle के विस्तारित लॉग को ./gradlew build --info कमांड द्वारा अस्थायी रूप से सक्षम करना उपयोगी है — आउटपुट में यह देखा जा सकेगा कि किस अनुरोध पर कनेक्शन टूट रहा है और सर्वर कौन सा प्रतिक्रिया कोड लौटाता है।

प्रॉक्सी के साथ प्रमाणीकरण: लॉगिन और पासवर्ड

यदि प्रॉक्सी प्रमाणीकरण की आवश्यकता है (यह भुगतान किए गए प्रॉक्सी सेवाओं और कॉर्पोरेट गेटवे के लिए एक मानक स्थिति है), तो gradle.properties में दो और पंक्तियाँ जोड़नी होंगी:

systemProp.http.proxyUser=myuser
systemProp.http.proxyPassword=mypassword
systemProp.https.proxyUser=myuser
systemProp.https.proxyPassword=mypassword

प्रॉक्सी का पासवर्ड परियोजना के gradle.properties में खुली स्थिति में रखना, जो संस्करण नियंत्रण प्रणाली में जाती है — एक खराब प्रथा है। उपयोगकर्ता के होम डायरेक्टरी में एक वैश्विक फ़ाइल का उपयोग करें, जो Git में कमिट नहीं होती है, या CI/CD चरण के दौरान पर्यावरण चर के माध्यम से पासवर्ड पास करें, ताकि रहस्य रिपॉजिटरी में लीक न हों।

उन परिदृश्यों के लिए जहाँ IP का रोटेशन आवश्यक है (जैसे, विभिन्न पते से API की सीमाओं का परीक्षण करना), प्रॉक्सी सेवाओं को तैयार पते के पूल और एकल लॉगिन के साथ लेना अधिक सुविधाजनक है — तब रोटेशन प्रदाता की ओर से सेट किया जाता है, और gradle.properties में केवल सत्र का पोर्ट बदलता है, बिना पूरे प्रोजेक्ट की कॉन्फ़िगरेशन को फिर से लिखे।

डायग्नोस्टिक चेकलिस्ट

यदि सभी सेटिंग्स के बाद भी सिंक्रनाइज़ेशन विफल हो रहा है, तो निम्नलिखित बिंदुओं को क्रम से जाँचें:

  • प्रॉक्सी की उपलब्धता को सीधे कमांड curl -x http://proxy.example.com:8080 https://dl.google.com द्वारा जाँचें
  • यह सुनिश्चित करें कि सेटिंग्स Settings → HTTP Proxy और gradle.properties में एक साथ निर्दिष्ट हैं
  • Gradle कैश को साफ़ करें: ./gradlew --stop और .gradle/caches फ़ोल्डर को हटा दें
  • यह सुनिश्चित करें कि फ़ाइल में host/port के मानों के चारों ओर कोई अतिरिक्त स्पेस और कोटेशन नहीं हैं
  • यदि SOCKS5 का उपयोग किया जा रहा है — तो http.proxyHost के बजाय socksProxyHost/socksProxyPort निर्दिष्ट करें
  • कॉर्पोरेट MITM प्रॉक्सी के लिए, प्रमाणपत्र को JDK के विश्वसनीय प्रमाणपत्र संग्रह में आयात करें (keytool -import)
  • properties फ़ाइलों में किसी भी परिवर्तन के बाद Android Studio और Gradle Daemon को पुनः प्रारंभ करें

निष्कर्ष

Android विकास में प्रॉक्सी सेटअप तीन स्तरों पर काम करना है: Android Studio के लिए सिस्टम सेटिंग्स, बिल्ड प्रक्रिया के लिए gradle.properties में systemProp पैरामीटर, और स्टैंडअलोन उपयोगिताओं जैसे sdkmanager के लिए अलग कॉन्फ़िगरेशन। अधिकांश सिंक्रनाइज़ेशन त्रुटियाँ वास्तव में इसलिए होती हैं क्योंकि एक स्तर सेट किया गया है, जबकि दूसरा भूल गया है, या प्रॉक्सी पर प्रमाणीकरण की कमी के कारण जो इसकी आवश्यकता होती है।

यदि कार्य केवल निर्भरताएँ और SDK घटक एक कार्यशील प्रॉक्सी के माध्यम से स्थिर रूप से डाउनलोड करना है, तो इसके लिए डेटा केंद्र प्रॉक्सी बहुत अच्छे हैं — ये तेज़ हैं और बड़े डाउनलोड के दौरान कोई अतिरिक्त देरी नहीं पैदा करते हैं। और यदि आपको यह परीक्षण करने की आवश्यकता है कि ऐप किसी विशेष देश के उपयोगकर्ता या मोबाइल ऑपरेटर के लिए कैसे व्यवहार करता है, तो रिहायशी प्रॉक्सी या मोबाइल IP पर विचार करें — ये विभिन्न क्षेत्रों में सेवाओं के व्यवहार की अधिक वास्तविक तस्वीर प्रदान करते हैं।