pdf

डिपेंडेंसी का एलान करना

pdf पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट में Google Maven रिपॉज़िटरी जोड़नी होगी. ज़्यादा जानकारी के लिए, Google की Maven रिपॉज़िटरी पढ़ें.

अपने ऐप्लिकेशन या मॉड्यूल के लिए, build.gradle फ़ाइल में उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको ज़रूरत है:

dependencies {
    implementation "androidx.pdf:pdf-viewer-fragment:1.0.0-alpha10"
}

dependencies {
    implementation("androidx.pdf:pdf-viewer-fragment:1.0.0-alpha10")
}

डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.

सुझाव/राय दें या शिकायत करें

आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको कोई नई समस्या मिलती है या इस लाइब्रेरी को बेहतर बनाने के लिए आपके पास कोई सुझाव है, तो हमें बताएं. कृपया नई लाइब्रेरी बनाने से पहले, इस लाइब्रेरी में मौजूद मौजूदा समस्याओं को देखें. स्टार बटन पर क्लिक करके, किसी मौजूदा समस्या के लिए वोट किया जा सकता है.

नई समस्या बनाना

ज़्यादा जानकारी के लिए, Issue Tracker का दस्तावेज़ देखें.

इस आर्टफ़ैक्ट के लिए कोई रिलीज़ नोट नहीं है.

वर्शन 1.0

वर्शन 1.0.0-alpha10

16 जुलाई, 2025

androidx.pdf:pdf-*:1.0.0-alpha10 रिलीज़ हो गया है. वर्शन 1.0.0-alpha10 में ये कमिट शामिल हैं.

नई सुविधाएं

• बेहतर तरीके से टेक्स्ट चुनने की सुविधा. इससे उपयोगकर्ता, पेज की सीमाओं से बाहर सिलेक्शन हैंडल को खींचकर, एक से ज़्यादा पेजों पर मौजूद टेक्स्ट को चुन सकते हैं.
• अब ऐप्लिकेशन, PDF दस्तावेज़ों में हाइपरलिंक पर क्लिक करने की प्रोसेस को रोक सकते हैं और उसे अपने हिसाब से बना सकते हैं.

एपीआई में हुए बदलाव

• यह PDF कॉन्टेंट दिखाने के लिए, कंपोज़ेबल को दिखाता है (I8e7ee)
• PdfPoint और PdfRect को androidx.pdf.models पैकेज (I26cf4) में ट्रांसफ़र किया जा रहा है
• यह PDF कॉन्टेंट दिखाने के लिए, View कॉम्पोनेंट को दिखाता है (I9fe27)
• यह एपीआई, PDF फ़ाइलों को पहले से ही शुरू करने के लिए उपलब्ध कराता है. इससे कोल्ड-स्टार्ट लेटेंसी (a18fa89) कम हो जाती है
• एपीआई को पीडीएफ़ कॉन्टेंट पर हाइपरलिंक क्लिक हैंडलिंग को बदलने की अनुमति देता है(6330a8b)
• pdf-document-service नाम के नए आर्टफ़ैक्ट और उससे जुड़े एपीआई - PdfLoader, PdfDocument, और SandboxedPdfLoader को दिखाता है. इन इंटरफ़ेस का इस्तेमाल, PDF दस्तावेज़ (Ide70d) के पार्सिंग और प्रोसेसिंग कॉम्पोनेंट को लागू करने के लिए किया जा सकता है
• यह एपीआई, दस्तावेज़ की रेंडरिंग शुरू करने के लिए, PdfDocument को PdfView पर सेट करता है (If8738)

वर्शन 1.0.0-alpha09

7 मई, 2025

androidx.pdf:pdf-*:1.0.0-alpha09 रिलीज़ हो गया है. वर्शन 1.0.0-alpha09 में ये कमिट शामिल हैं.

बड़े बदलाव

• कोडबेस को फिर से बनाया गया है. अब इसे पूरी तरह से Kotlin में लिखा गया है. इसमें Coroutines और ViewModel का इस्तेमाल किया गया है. इसमें PdfViewerFragment को फिर से लागू करना शामिल है. इस रिलीज़ में कोई नया एपीआई या सुविधा शामिल नहीं है.

ऐसी समस्याएं जिनके बारे में हमें पता है:

• फ़ास्ट स्क्रोलर और पेज इंडिकेटर में शैडो इफ़ेक्ट मौजूद नहीं हैं.
• ऐसा हो सकता है कि एक पेज वाले PDF दस्तावेज़ हमेशा व्यू की चौड़ाई के हिसाब से बीच में न दिखें और उनका साइज़ भी व्यू की चौड़ाई के हिसाब से न हो.

एपीआई में हुए बदलाव

• @StyleRes की मदद से containerStyleResId को एनोटेट करें. (I88d85)

वर्शन 1.0.0-alpha08

12 मार्च, 2025

androidx.pdf:pdf-document-service:1.0.0-alpha08, androidx.pdf:pdf-viewer:1.0.0-alpha08, और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha08 रिलीज़ किए गए हैं. वर्शन 1.0.0-alpha08 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• स्केलिंग में अंतर की वजह से, अलग-अलग Android डिवाइसों के बीच सिलेक्शन मेन्यू की जगह में अंतर की समस्या ठीक की गई. अब सभी डिवाइसों पर, चुनने के लिए मेन्यू एक ही जगह पर दिखता है.
• कॉन्फ़िगरेशन में बदलाव वगैरह जैसे मामलों में, फ़्रैगमेंट को फिर से बनाने पर फ़ास्ट स्क्रोलर और पेज इंडिकेटर की पोज़िशन को अलाइन किया गया

वर्शन 1.0.0-alpha07

26 फ़रवरी, 2025

androidx.pdf:pdf-document-service:1.0.0-alpha07, androidx.pdf:pdf-viewer:1.0.0-alpha07, और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha07 रिलीज़ किए गए हैं. वर्शन 1.0.0-alpha07 में ये कमिट शामिल हैं.

नई सुविधाएं

• PdfViewerFragment अब StylingOptions (स्टाइल रिसॉर्स आईडी का सेट) के साथ काम करता है. इससे newInstance या एक्सएमएल (FragmentContainerView) के ज़रिए कस्टम स्टाइलिंग की जा सकती है. सबक्लास, मिलती-जुलती सुविधाओं के लिए प्रोटेक्टेड कंस्ट्रक्टर का इस्तेमाल कर सकते हैं.
• StylingOptions फ़िलहाल containerStyle से इनपुट लेता है. इससे ये सुविधाएं मिलती हैं:
  • तेज़ी से स्क्रोल करने वाले हैंडल और पेज इंडिकेटर के लिए, कस्टम ड्रॉएबल की सुविधा.
  • marginEnd एट्रिब्यूट का इस्तेमाल करके, फ़ास्ट स्क्रोल हैंडल और पेज इंडिकेटर को सटीक जगह पर रखा जाता है.

एपीआई में हुए बदलाव

• PdfView से सार्वजनिक एट्रिब्यूट जोड़े गए (I30fc5)
• PDF व्यू के लिए, नए एपीआई StylingOptions जोड़े गए. (Id2993)

गड़बड़ियां ठीक की गईं

• तेज़ी से स्क्रोल करने वाले हैंडल और पेज इंडिकेटर की दिखने की स्थिति के बीच सिंक करने से जुड़ी गड़बड़ी को ठीक किया गया है.

वर्शन 1.0.0-alpha06

29 जनवरी, 2025

androidx.pdf:pdf-document-service:1.0.0-alpha06, androidx.pdf:pdf-viewer:1.0.0-alpha06, और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha06 रिलीज़ किए गए हैं. वर्शन 1.0.0-alpha06 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• ठीक किया गया: रजिस्टर नहीं की गई सेवा को अनबाइंड करने पर, IllegalArgumentException की वजह से क्रैश होने की समस्या (eb4e85)
• ठीक किया गया: mMaxPages और numPages में अंतर होने की वजह से, IllegalArgumentException क्रैश हो जाता था. (75d763)

वर्शन 1.0.0-alpha05

11 दिसंबर, 2024

androidx.pdf:pdf-document-service:1.0.0-alpha05, androidx.pdf:pdf-viewer:1.0.0-alpha05, और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha05 रिलीज़ किए गए हैं. वर्शन 1.0.0-alpha05 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• यह लाइब्रेरी अब JSpecify nullness annotations का इस्तेमाल करती है. ये टाइप-यूज़ होते हैं. Kotlin डेवलपर को सही इस्तेमाल के लिए, कंपाइलर के इस तर्क का इस्तेमाल करना चाहिए: -Xjspecify-annotations=strict (यह Kotlin कंपाइलर के 2.1.0 वर्शन से डिफ़ॉल्ट रूप से शुरू होता है). (I38301, b/326456246)
• Android 13 में, स्क्रीन घुमाने के बाद पहले से खुला हुआ पेज दिखने की समस्या ठीक की गई. (Ib03dd)
• रोटेशन के दौरान टूलबॉक्स के गायब होने की समस्या ठीक की गई. (01148f)

वर्शन 1.0.0-alpha04

13 नवंबर, 2024

androidx.pdf:pdf-viewer:1.0.0-alpha04 और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha04 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha04 में ये कमिट शामिल हैं.

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

• PDFViewer लाइब्रेरी अब Android के S, T, U, और V वर्शन के साथ काम करती है. यह बेहतर तरीके से काम करने की सुविधा, एसडीके एक्सटेंशन 13 के अपडेट से जुड़ी है.

एपीआई में हुए बदलाव

• PdfViewerFragment के लिए, कम से कम SdkExtension की शर्त जोड़ी गई. (I922af)
• PDF Viewer लाइब्रेरी के लिए नए एपीआई उपलब्ध कराए गए हैं. (I0af57)

गड़बड़ियां ठीक की गईं

• ऐप्लिकेशन की प्रोसेस बंद होने की समस्या को ठीक करने के लिए, क्रैश फ़िक्स किया गया है.
• पासवर्ड डायलॉग से जुड़े यूज़र इंटरफ़ेस (यूआई) की गड़बड़ियां ठीक की गई हैं.
• findInFileView और FastscrollView के लिए, ऐक्सेसिबिलिटी से जुड़ी समस्याएं ठीक की गई हैं.

लगातार डेवलपमेंट

• हम लाइब्रेरी में Jetpack Compose को शामिल करने पर काम कर रहे हैं.

वर्शन 1.0.0-alpha03

18 सितंबर, 2024

androidx.pdf:pdf-viewer:1.0.0-alpha03 और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha03 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha03 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• सर्च सुविधा को पहली बार खोलने पर कीबोर्ड नहीं दिखने की समस्या ठीक की गई
• FindInFile व्यू के फ़ॉन्ट से जुड़ी यूज़र इंटरफ़ेस (यूआई) की गड़बड़ियां ठीक की गईं.
• टेक्स्ट चुनने और ड्रैग हैंडल के लिए यूज़र इंटरफ़ेस से जुड़ी समस्याएं ठीक की गईं.

ऐसी समस्याएं जिनके बारे में जानकारी पहले से है

• PDF दस्तावेज़ों में मौजूद 3D इमेज, व्यूअर में रेंडर नहीं होती हैं.
• PdfViewerFragment को बहुत बड़े PDF दस्तावेज़ों (> 250 एमबी) पर कुछ परफ़ॉर्मेंस से जुड़ी समस्याएं हैं

वर्शन 1.0.0-alpha02

4 सितंबर, 2024

androidx.pdf:pdf-viewer:1.0.0-alpha02 और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha02 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha02 में ये कमिट शामिल हैं.

गड़बड़ियां ठीक की गईं

• पोर्ट्रेट से लैंडस्केप मोड में घुमाने पर, PDF इमेज के धुंधली दिखने की समस्या को ठीक किया गया है. साथ ही, ऐप्लिकेशन के स्लीप मोड में जाने की समस्या को भी ठीक किया गया है.
• 'फ़ाइल में ढूंढें' मेन्यू में, कॉन्फ़िगरेशन में बदलाव होने पर भी नतीजों की संख्या बनी रहती है.
• FloatingActionButton आइकॉन अब एक पेज वाले PDF के लिए उपलब्ध है.
• 'फ़ाइल में ढूंढें' बार और FloatingActionButton के बीच ओवरलैप होने वाली समस्याओं को ठीक कर दिया गया है.
• अब व्यूअर में टेक्स्ट और हाइलाइट एनोटेशन रेंडर किए जा सकते हैं.
• 'फ़ाइल में ढूंढें' बार में सुलभता से जुड़ी सुविधाओं को बेहतर बनाया गया है.
• रोटेशन के लिए यूज़र इंटरफ़ेस (यूआई) से जुड़ी समस्याओं को ठीक कर दिया गया है. इनमें, गिनती को बनाए रखना, टेक्स्ट चुनने वाले मेन्यू के गायब होने की समस्या को ठीक करना, और फ़्लोटिंग ऐक्शन बटन (एफ़एबी) के ओवरलैप होने की समस्या को हल करना शामिल है.
• लैंडस्केप मोड में कीबोर्ड के पीछे छिपे हुए, 'फ़ाइल में ढूंढें' मेन्यू की समस्या को ठीक कर दिया गया है.

ऐसी समस्याएं जिनके बारे में जानकारी पहले से है

• PDF दस्तावेज़ों में मौजूद 3D इमेज, व्यूअर में रेंडर नहीं होती हैं.
• PdfViewerFragment को बहुत बड़े PDF दस्तावेज़ों (> 250 एमबी) पर कुछ परफ़ॉर्मेंस से जुड़ी समस्याएं हैं

वर्शन 1.0.0-alpha01

7 अगस्त, 2024

androidx.pdf:pdf-viewer:1.0.0-alpha01 और androidx.pdf:pdf-viewer-fragment:1.0.0-alpha01 रिलीज़ हो गए हैं. वर्शन 1.0.0-alpha01 में ये कमिट शामिल हैं.

नई सुविधाएं

PDFViewer के शुरुआती ऐल्फ़ा वर्शन में, पीडीएफ़ पढ़ने से जुड़े मुख्य कामों को पूरा करने में मदद करने वाली सुविधाएं शामिल हैं. कृपया ध्यान दें कि फ़िलहाल, PdfViewerFragment सिर्फ़ Android V (SDK 35) वर्शन पर काम करता है. आने वाले समय में, Android के पुराने वर्शन के लिए भी यह सुविधा उपलब्ध होगी.

• PdfViewerFragment को लॉन्च किया गया है. आपका ऐप्लिकेशन इसका इस्तेमाल करके, PDF दस्तावेज़ को रेंडर कर सकता है. PdfViewerFragment की मदद से, अपनी गतिविधि में PDF व्यूअर को आसानी से इंटिग्रेट किया जा सकता है. साथ ही, उपयोगकर्ताओं को इन तरीकों से इंटरैक्ट करने की सुविधा मिलती है:
  • ज़ूम करना: पढ़ने में आसानी हो, इसके लिए ज़ूम लेवल को अडजस्ट करने के लिए पिंच इन और पिंच आउट करें. साथ ही, डिफ़ॉल्ट स्थिति में तुरंत ज़ूम इन/आउट करने के लिए दो बार टैप करें.
  • नेविगेशन: डिफ़ॉल्ट/ज़ूम की गई स्थिति में स्क्रोल करें. PdfViewerFragment में, पेजों के बीच तेज़ी से स्क्रोल करने के लिए क्विक स्क्रबर की सुविधा मिलती है.
  • टेक्स्ट से जुड़ी कार्रवाइयां: टेक्स्ट पर देर तक टैप करने से वह चुना जाता है. इससे उपयोगकर्ता, मौजूदा पेज पर मौजूद 'कॉपी करें' और 'सभी चुनें' जैसे विकल्पों का इस्तेमाल कर सकते हैं.
  • पासवर्ड से सुरक्षित किए गए दस्तावेज़: PdfViewerFragment उपयोगकर्ता को एक डायलॉग बॉक्स दिखाता है, ताकि वह पासवर्ड डालकर दस्तावेज़ खोल सके.
  • नेविगेट किए जा सकने वाले हाइपरलिंक: उपयोगकर्ता, PDF में मौजूद हाइपरलिंक पर टैप करके वेब यूआरएल या बुकमार्क पर जा सकते हैं.
  • एनोटेशन मोड पर जाने का शॉर्टकट: फ़िलहाल, PdfViewerFragment में बदलाव मोड काम नहीं करता. इसके बजाय, PdfViewerFragment एक FloatingActionButton दिखाता है, जो दस्तावेज़ के यूआरआई के साथ एक इंप्लिसिट android.intent.action.ANNOTATE इंटेंट को ट्रिगर करता है.

एपीआई में हुए बदलाव

• दस्तावेज़ के लिए फ़ाइल या कॉन्टेंट यूआरआई सेट करने और दस्तावेज़ को लोड करने की प्रोसेस शुरू करने के लिए, PdfViewerFragment.documentUri प्रॉपर्टी जोड़ी गई है. PdfViewerFragment यूआरआई सेट होने पर, लोडिंग स्पिनर दिखाता है. इससे पता चलता है कि दस्तावेज़ की बैकग्राउंड प्रोसेसिंग हो रही है.
• 'फ़ाइल में ढूंढें' मेन्यू को दिखाने या छिपाने के लिए, PdfViewerFragment.isTextSearchActive जोड़ा गया. PdfViewerFragment पूरे फ़्लो को मैनेज करता है. जैसे, इनपुट की अनुमति देना, मैच की कुल संख्या दिखाना, नतीजों के बीच नेविगेट करने की सुविधा चालू करना, और इससे बाहर निकलना.
• onDocumentLoadSuccess और onDocumentLoadError कॉलबैक जोड़े गए हैं. ये कॉलबैक, दस्तावेज़ के रेंडर हो जाने के बाद या रेंडर होने से पहले गड़बड़ी होने पर शुरू होते हैं.

ऐसी समस्याएं जिनके बारे में जानकारी पहले से है

• कुछ मामलों में, फ़ाइल में ढूंढें बार, FloatingActionButton से ओवरलैप होता है.
• एक पेज वाले PDF के लिए, FloatingActionButton आइकॉन नहीं दिखता.
• 'फ़ाइल में ढूंढें' मेन्यू में कॉन्फ़िगरेशन बदलने पर, नतीजों की संख्या नहीं बनी रहती.
• 'फ़ाइल में ढूंढें' मेन्यू को बंद करते समय, स्क्रीन पर फ़्लिकरिंग दिखती है
• PDF दस्तावेज़ों में मौजूद 3D इमेज, व्यूअर में रेंडर नहीं होती हैं.
• सुलभता सुविधाएं, आने वाली रिलीज़ में चालू की जाएंगी.
• PDF इमेज को पोर्ट्रेट से लैंडस्केप में घुमाने पर, वह धुंधली हो जाती है.
• टेक्स्ट/हाइलाइट एनोटेशन की सुविधा उपलब्ध नहीं है.
• PdfViewerFragment को बहुत बड़े PDF दस्तावेज़ों (> 250 एमबी) पर कुछ परफ़ॉर्मेंस से जुड़ी समस्याएं हैं

ध्यान दें

• compileSdk को 35 5dc41be पर अपडेट करें