Editor tools

Tools कैसे खुलते हैं

ये tools सिर्फ़ कोड एडिटर के अंदर मौजूद हैं; ये मुख्य pager के पेज नहीं हैं। पहले कोई फ़ाइल या प्रोजेक्ट खोलें, फिर एडिटर के ऊपर वाले रिंच बटन का इस्तेमाल करें।

1. 1एडिटर की टॉप बार में रिंच बटन (More options) पर टैप करें। एक sheet खुलती है जिसमें सर्च फ़ील्ड Search action… होता है।
2. 2किसी सेक्शन चिप को चुनें: Edit, View, Go to, Git, AI या Tools, या सभी actions को एक साथ फ़िल्टर करने के लिए सर्च फ़ील्ड में टाइप करें।
3. 3Tools में actions इन समूहों में बँटे हैं: Run, Project, Collaborate, Utilities और Help & settings। Debug, Test Explorer और Dependencies Run में हैं; Docker Tools, Monitoring और Backend Generators Project में; Live Collaboration Collaborate में।
4. 4Problems और Outline Go to में हैं। AI Generators और AI code actions AI में हैं।
5. 5command palette (हार्डवेयर कीबोर्ड पर Ctrl+Shift+P) बिल्कुल यही actions दिखाता है: मेन्यू और palette एक ही registry साझा करते हैं।

हर tool कहाँ है

Sheet, डॉक्ड पैनल, डायलॉग या साइड कॉलम

Shortcuts

Debug

Debug खुली हुई फ़ाइल को debugger जोड़कर चलाता है और एडिटर के नीचे डॉक्ड पैनल में दिखाता है कि प्रोग्राम क्या कर रहा है। Debugger सिर्फ़ JavaScript के लिए असली है (.js, .mjs, .cjs, .jsx, जो built-in Node.js पर चलते हैं)। किसी भी दूसरी भाषा के लिए Debug File बस फ़ाइल चला देता है।

Breakpoints

• Breakpoint जोड़ने या हटाने के लिए एडिटर में लाइन नंबर पर टैप करें, या कर्सर की लाइन पर F9 दबाएँ (Toggle breakpoint)। इन्हें session शुरू करने से पहले भी सेट किया जा सकता है।
• Breakpoints सिर्फ़ मेमोरी में रहते हैं: ऐप बंद करने पर वे भूल जाते हैं।
• Breakpoints टैब हर breakpoint को on/off बॉक्स के साथ सूची में दिखाता है। किसी पंक्ति पर टैप करके मौजूदा फ़ाइल में उसकी लाइन पर जाएँ, पेंसिल से उसे edit करें, ✕ से हटाएँ, या Clear all। सूची खाली हो तो: “No breakpoints. Tap a line number in the editor to add one.”

शुरू करना और step करना

Node अपनी पहली लाइन पर रुककर शुरू होता है (--inspect-brk), पैनल उससे जुड़ता है (run output में “Debugger attached on port N” दिखता है) और उसे छोड़ देता है, और प्रोग्राम तब तक चलता है जब तक कोई breakpoint या uncaught exception न आ जाए, जो उसे भी रोक देता है।

• Session सक्रिय होने पर टूलबार में Continue (या चलते समय Pause), Step Over, Step Into, Step Out, Restart और Stop मिलते हैं। Step बटन सिर्फ़ तब सक्रिय होते हैं जब प्रोग्राम रुका हो।
• Stop debugger को अलग कर देता है। प्रोसेस को खुद run पैनल से रोका जाता है।
• आग वाला toggle, Hot Reload: restart the session when a project file is saved, डिफ़ॉल्ट रूप से बंद रहता है।

चार टैब

टैब के नाम हमेशा अंग्रेज़ी में रहते हैं: ऐप उनका अनुवाद नहीं करता।

Conditions और logpoints

Breakpoint की पेंसिल Edit breakpoint खोलती है। Condition (“Pause only when this JavaScript expression is true”) उसे सिर्फ़ तभी रोकती है। Log message (“Log instead of pausing. Use {expression} to insert values”) उसे ऐसा logpoint बना देता है जो संदेश छापता है और रोकता नहीं। दोनों होने पर वह सिर्फ़ तब छापता है जब condition सही हो। ये दोनों फ़ील्ड यहीं सेट होते हैं, एडिटर के margin से नहीं।

Testing

Test Explorer आपके प्रोजेक्ट के tests ढूँढता है, framework के अपने कमांड से उन्हें चलाता है और नतीजे सूची में दिखाता है। इसके साथ कोई test runner नहीं आता: यह कमांड को डिवाइस के shell (sh -c) से प्रोजेक्ट फ़ोल्डर में चलाता है, इसलिए framework के tools डिवाइस पर मौजूद होने चाहिए।

Frameworks और पहचान

बारह frameworks समर्थित हैं: Jest, Mocha, Vitest, pytest, unittest, JUnit, Go Test, Cargo Test, PHPUnit, RSpec, Dart Test और Swift XCTest। PocketCode हर प्रोजेक्ट के लिए एक चुनता है: जो सबसे पहले उसकी config फ़ाइल से मिले (उदाहरण के लिए jest.config.js, pytest.ini, build.gradle, go.mod, Cargo.toml, pubspec.yaml); कोई न मिले तो Jest, Vitest या Mocha के लिए package.json पढ़ता है। unittest की कोई config फ़ाइल नहीं होती, इसलिए वह कभी अपने-आप नहीं चुना जाता। उसके बाद subtitle “<framework> · N tests in M files” दिखाता है।

चार टैब

चलाना

• Footer में Run all, Failed only और, run चल रहा हो तो, Stop होते हैं।
• Header में Refresh, Toggle watch mode और Run with coverage के आइकन होते हैं।
• Test tree आपकी फ़ाइलें नाम के patterns (*.test.*, test_*.py, *_test.go, *Test.kt…) से पढ़कर बनता है, अधिकतम 200 फ़ाइलें, और node_modules, .git, build, dist, target, .gradle, __pycache__ और venv को छोड़ दिया जाता है।
• Watch mode सिर्फ़ Jest, Mocha और Vitest के लिए है, और वह बस कमांड का output Output में स्ट्रीम करता है।

Docker Tools

Docker Tools आपके डिवाइस पर पहले से मौजूद docker command-line tool का front end है। PocketCode में Docker या Docker daemon शामिल नहीं है, और पैनल में remote host के लिए कोई फ़ील्ड नहीं है। इसलिए आम फ़ोन पर जिन टैब को Docker चाहिए वे Docker isn’t reachable दिखाते हैं, जबकि Dockerfile और Compose एडिटर काम करते रहते हैं।

जब Docker न हो

खुलते समय पैनल docker --version चलाता है। वह फ़ेल हो तो Containers, Images, Build और Registry Docker isn’t reachable दिखाते हैं: “PocketCode runs the docker command on this device and couldn’t find it. You can still edit the Dockerfile and the Compose file.” यह असली कारण और दो बटन जोड़ता है, Try again और Edit Dockerfile। Subtitle में Docker not available लिखा होता है।

Dockerfile और .dockerignore

यह टैब Docker के बिना भी काम करता है। 14 templates में से किसी से शुरू करें — Node.js App, Python App, Java App, Go App, Rust App, Static Site, React App, Next.js, FastAPI, Spring Boot, Django, Ruby on Rails, Laravel, Custom Multi-stage — टेक्स्ट बदलें और प्रोजेक्ट में उसे Dockerfile नाम से Save करें। .dockerignore के लिए आप फ़ाइल Generate करके सेव कर सकते हैं।

Compose

नौ templates: Full-stack Node.js, Full-stack Python, Full-stack Java, LAMP Stack, MEAN Stack, Monitoring Stack, ELK Stack, WordPress और Dev Tools। फ़ाइल को edit करके Save करें; वह हमेशा docker-compose.yml नाम से सेव होती है, भले ही पैनल docker-compose.yml, docker-compose.yaml, compose.yml या compose.yaml पढ़ता हो। Docker मौजूद होने पर Compose up, Compose down, Compose build और Compose logs क्रमशः docker compose up -d, down, build और logs --tail=100 चलाते हैं; जब तक प्रोजेक्ट में Compose फ़ाइल न हो, वे निष्क्रिय रहते हैं।

Docker उपलब्ध होने पर

कमांड की सीमाएँ

हर कमांड अधिकतम 300 सेकंड चल सकता है। नाम और tags Docker तक पहुँचने से पहले जाँचे जाते हैं: अक्षर, अंक और _ : . / @ -, अधिकतम 255 अक्षर, और - से शुरू नहीं।

Monitoring

Monitoring उस ऐप को और उस डिवाइस को मापता है जिसमें आप हैं, किसी server को नहीं। पैनल खुला रहने तक यह हर 2 सेकंड में sample लेता है और बंद करने पर रुक जाता है। अपना खुद का server देखने के लिए अलग Server टैब है।

पाँच टैब

Alert rules

Rule के फ़ॉर्म में Metric, Condition (Greater than या Less than), Threshold (metric की range के विरुद्ध जाँचा जाता है), Sustained for (seconds) और Severity (Critical, Warning, Info) होते हैं। Alert events सिर्फ़ तभी evaluate होकर दिखते हैं जब पैनल खुला हो; आख़िरी 100 रखे जाते हैं, हर rule के लिए प्रति मिनट अधिकतम एक।

Server: आपका अपना Prometheus

Server Prometheus, VictoriaMetrics, Thanos, Mimir, Cortex या Grafana proxy के साथ काम करता है। Address डालें, Authentication चुनें (None, User and password या Bearer token), refresh चुनें (5 से 300 सेकंड, डिफ़ॉल्ट 15) और 12 तक queries जोड़ें; हर query एक PromQL instant query है जो एक ही मान लौटाए। Test connection सेटअप जाँचता है। जब तक आप इसे configure नहीं करते, टैब यह दिखाता है: “No server configured. Nothing leaves this device until you set one up.”

Libraries

Libraries (मेन्यू इसे Dependencies कहता है) कोई package manager नहीं है। यह उन Kotlin/JVM libraries की सूची दिखाती है जो प्रोजेक्ट .pocketcode/dependencies.json में declare करता है, और आपको चार libraries के बंद catalog में से चुनने देती है जो PocketCode ऐप के अंदर ही आती हैं। इन्हें सिर्फ़ पूरा Kotlin runner इस्तेमाल करता है।

Catalog

Catalog टैब PocketCode में शामिल चार libraries दिखाता है: kotlinx.coroutines 1.10.2, kotlinx.serialization · JSON 1.7.3, kotlinx.serialization · core 1.7.3 और Okio 3.9.1। किसी पंक्ति का + आइकन (Add और library का नाम) उसे प्रोजेक्ट में जोड़ देता है।

Declared

Declared टैब वह दिखाता है जो प्रोजेक्ट का JSON declare करता है, फ़िल्टर All, Outdated और Not included के साथ। हर पंक्ति group:artifact दिखाती है और यह भी कि PocketCode उसे शामिल करता है या नहीं (“Included with PocketCode.”, या “a → b” जब प्रोजेक्ट कोई दूसरा version माँगता है), साथ में update आइकन और remove आइकन। नीचे का Update N हर outdated library को update करता है, यानी उसे उस version पर सेट करता है जो PocketCode में शामिल है। Header का refresh आइकन (Resolve now) libraries को दोबारा तैयार करता है, “Preparing the libraries…” और “Ready: this project’s libraries are prepared.” स्थितियों के साथ। Declarations न हों तो यह No dependencies दिखाता है।

जो library शामिल नहीं है

अगर JSON में catalog से बाहर की कोई चीज़ हो, तो पंक्ति बताती है कि वह PocketCode के साथ नहीं आती, “so this project runs in simple mode. Remove it, or use one of the libraries above.”

Backend Generators

Backend Generators ऐप में रखे templates से server कोड लिखते हैं। यह AI नहीं है: वही settings हमेशा वही फ़ाइलें देती हैं (Generate बटन बस पहले थोड़ी देर रुकते हैं)। आप नतीजा sheet में पढ़ते हैं और, प्रोजेक्ट खुला हो तो, उसे backend/ के अंदर सेव करते हैं।

टैब

Save to project

Save to project बनी हुई फ़ाइलें प्रोजेक्ट में backend/ के नीचे लिखता है; migrations backend/up.sql और backend/down.sql बनती हैं, और spec backend/openapi.yaml या backend/openapi.json। Paths प्रोजेक्ट फ़ोल्डर से बाहर नहीं जा सकते। कुछ फ़ाइलें पहले से हों तो यह Overwrite files? पूछता है (“N file(s) already exist in the project and will be overwritten.”)। सफल होने पर यह “Saved N file(s) to backend/ in the project” कहता है, और लिखना फ़ेल हो तो “Couldn’t save the generated files”। इसके लिए प्रोजेक्ट खुला होना चाहिए।

AI Generators

AI Generators में पाँच टैब हैं, लेकिन सिर्फ़ तीन AI इस्तेमाल करते हैं। API और Schema डिवाइस पर चलने वाले offline templates हैं; Translate, Security और Performance आपका चिपकाया कोड आपके जुड़े हुए AI provider को भेजते हैं।

पाँच टैब

AI टैब को क्या चाहिए

एक जुड़ा हुआ AI provider और इंटरनेट। पहली बार एक सूचना Send to <provider>? पूछती है; Send आपका चिपकाया कोड साझा करता है, Cancel कुछ भी साझा नहीं करता। API और Schema को न provider चाहिए, न नेटवर्क। बनाने से पहले नतीजे वाला हिस्सा “The result will appear here once generated.” दिखाता है।

AI code actions

मेन्यू के AI सेक्शन में ऐसे actions हैं जो आपके कोड पर काम करते हैं: explain, tests, docs, comments से कोड, refactor और पाँच quick actions। ये आपकी स्वीकार की गई सूचना के बाद कोड को आपके जुड़े हुए AI provider को भेजते हैं और जवाब दिखाते हैं।

Actions

डॉक्ड पैनल में Apply और Insert

डॉक्ड पैनल अधिकतम 300 dp ऊँचा होता है और बंद करने के लिए ✕ होता है। Insert जवाब को कर्सर पर डालता है। Apply सिर्फ़ उस कोड-हिस्से को जवाब से बदलता है जो AI को भेजा गया था (Generate Docs में वह function; Refactor में selection, या कुछ select न हो तो पूरी फ़ाइल), बिना preview के और एक ही undo स्टेप में। अगर AI के जवाब देते समय आपने वह कोड बदल दिया और वह अब मिलता नहीं, तो कुछ नहीं बदलता और पैनल कहता है “The code changed while the AI was answering, so the result was not applied. Copy it instead.” Copy बटन जनरेट किए गए कोड के बगल में है और उसे क्लिपबोर्ड पर कॉपी करता है (“Copied to clipboard”); bottom sheet में पूरे जवाब के लिए अपना Copy है।

Live Collaboration

Live Collaboration दो या अधिक डिवाइसों को एक ही Wi-Fi नेटवर्क पर एक फ़ाइल साथ मिलकर edit करने देता है। यह मुफ़्त है, इसके लिए अकाउंट नहीं चाहिए और कोई server नहीं है: host का फ़ोन आपके local network पर सुनता है, guests उसे ढूँढते हैं, छह अंकों का कोड डालते हैं और host उन्हें अंदर आने देता है। कुछ भी इंटरनेट से होकर नहीं जाता।

Session host करना

1. 1Host on this device के नीचे session का नाम लिखें और Start hosting पर टैप करें। Session आपकी खुली फ़ाइल का टेक्स्ट साझा करता है।
2. 2छह अंकों का Pairing code उसे दें जो join हो रहा है (“Give this code to whoever is joining”)।
3. 3जब कोई सही कोड डालता है, तो आपका डिवाइस Someone wants to join पूछता है: “<name> typed the right code. Letting them in shares the file with their device.” Let them in या Turn away चुनें। आपके पास 90 सेकंड तक का समय है।
4. 4Header में End Session से इसे समाप्त करें।

Session में join करना

1. 1उसी Wi-Fi पर पैनल खोलें। Peers on your network LAN को scan करता है (Scanning the LAN…) और कोई host न कर रहा हो तो No peers found कहता है।
2. 2Code from the host में host के छह अंक डालें (“Nobody can join without it. The session never leaves your network.”)।
3. 3Host पर टैप करें और उसके अंदर आने देने का इंतज़ार करें (120 सेकंड तक)। आपकी खुली फ़ाइल की सामग्री host के टेक्स्ट से बदल जाती है।
4. 4Header में Leave से बाहर निकलें।

Session के अंदर

क्या साझा होता है

• Session शुरू होने के समय host की सक्रिय फ़ाइल का टेक्स्ट। एक session एक buffer साझा करता है: प्रोजेक्ट tree नहीं, दूसरी फ़ाइलें नहीं।
• उसके बाद सभी के edits मर्ज हो जाते हैं (CRDT) और remote कर्सर एडिटर में नाम और रंग के साथ दिखते हैं।
• Host सब कुछ relay करता है: guests host से बात करते हैं, आपस में नहीं।
• Host जिस भी guest को अंदर आने देता है वह साझा टेक्स्ट edit कर सकता है।
• किसी guest का connection टूट जाए तो ऐप छह बार तक दोबारा कोशिश करता है (1 s से बढ़कर 15 s तक) और इस बीच जो टाइप हुआ उसे मिला लेता है।

नेटवर्क और permission

Android 13 से, host करने और join करने के लिए Android की nearby-devices permission चाहिए (सबसे नए Android versions में यह local-network permission है)। जब आप host, scan या join शुरू करते हैं और वह permission नहीं मिली होती, तो Android का अपना permission डायलॉग खुलता है: उसे दें और फिर टैप करें। अगर आप मना करते हैं, तो host और join ठुकराए जाते रहते हैं (अगली कोशिश में समझाइश फिर दिखती है), जब तक आप उसे Android की ऐप settings से नहीं देते। Permission की व्याख्या और connection errors ऐप की भाषा में दिखते हैं।

Problems

Problems एक ही सूची है जिसमें हर खुले टैब में एडिटर को जो भी गड़बड़ मिली है, फ़ाइल के हिसाब से समूहित, दिखती है। यह फ़ुल-स्क्रीन डायलॉग है, sheet नहीं।

Filters

Origin से फ़िल्टर करें — Compiler/LSP, Markers और Style, हर एक अपनी गिनती के साथ — और severity से — Errors, Warnings, Info और Hints। Compiler/LSP और Markers डिफ़ॉल्ट रूप से चालू हैं। Style (linter के rules) तभी गिना जाता है जब आप उसे चालू करें, “Analyzing style…” के साथ, और डायलॉग बंद रहने पर कुछ भी गिना नहीं जाता।

पंक्तियाँ

Problems की दोहराव हटाकर severity और फिर लाइन के हिसाब से क्रम में रखा जाता है। “Line N, Col M” पर जाने के लिए किसी पंक्ति पर टैप करें। सक्रिय फ़ाइल के समूह में Quick fixes होता है, जो quick-fixes पैनल खोलता है। F8 और Shift+F8 डायलॉग खोले बिना अगले या पिछले error, warning या TODO marker पर कूद जाते हैं। दिखाने को कुछ न हो तो No problems found लिखा होता है।

Outline

Outline एडिटर के दाईं ओर का कॉलम है जो फ़ाइल की classes, interfaces, functions, import blocks और // region सेक्शनों की सूची देता है और उन पर कूदने देता है। इसे एक सादा parser बनाता है; यह language server इस्तेमाल नहीं करता।

यह क्या पहचानता है

• वे लाइनें जो class, interface, object, enum class, fun या suspend fun से शुरू होकर { खोलती हैं — Kotlin-शैली की declarations।
• लगातार तीन या अधिक लाइनों के blocks जो import से शुरू होते हैं।
• // region Name के रूप में लिखे और // endregion से बंद किए गए regions।
• आपके टाइप करना रोकने के 0.8 सेकंड बाद यह ताज़ा होता है।

इस्तेमाल

Filter symbols… में टाइप करें (यह टेक्स्ट के हिस्से से मेल खाता है, fuzzy नहीं है) और किसी entry पर टैप करके उसकी लाइन पर जाएँ। फ़िल्टर किसी से मेल न खाए तो No symbols दिखता है।