كيفية اضافة ملف pdf الى برنامج اندرويد ستوديو؟!

هل تريدين أن تكون الكتب داخل التطبيق أم يتم تحميلها من الإنترنت 

اذا كانت الكتب داخل التطبيق :

يمكنك انشاء مجلد assets ثم وضع الكتب بداخله 

ثم استخدام مكتبة android-pdf-viewer و عبارة هي مكتبة مفتوحة المصدر وتقوم بعرض صفحات PDF و تدعم التكبير والتصغير و التمرير بين الصفحات و عرض صفحات متعددة بسلاسة

اما إذا كانت الكتب من الإنترنت :

هنا ستحتاجين الى خطوتين : تحميل الملف ثم تحويله إلى URI و تأكدي من إضافة صلاحية الإنترنت في AndroidManifest

<uses-permission android:name="android.permission.INTERNET"/>

بالتوفيق.

لعرض ملفات PDF داخل تطبيقك في Android Studio دون إجبار المستخدم على الخروج من التطبيق لفتح الكتاب tالطريقة الأفضل والأسهل هي استخدام مكتبة خارجية مخصصة لذلك وأشهرها مكتبة AndroidPdfViewer.

الخطوة الأولى إضافة ملف الـ PDF إلى مشروعك :

• يجب أن تضع ملف الكتاب داخل مجلد assets في مشروعك.
• في Android Studio، في نافذة Project تأكد من أنك على طريقة عرض Android.
• انقر بزر الماوس الأيمن على مجلد app.
• اختر New ثم Folder ثم Assets Folder.
• اضغط Finish وسيتم إنشاء المجلد داخل src/main/assets.
• قم بنسخ ملف الكتاب الخاص بك والصقه داخل مجلد assets الجديد.

الخطوة الثانية إضافة مكتبة عرض الـ PDF :

سنستخدم مكتبة AndroidPdfViewer لتسهيل التعامل مع تقليب الصفحات والتقريب (Zoom).

• افتح ملف settings.gradle وتأكد من وجود مستودع JitPack:

  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
          maven { url 'https://jitpack.io' }
      }
  }

• افتح ملف build.gradle.kts الخاص ب Module: app وأضف السطر التالي داخل قسم dependencies:

  implementation("com.github.barteksc:android-pdf-viewer:2.8.2")

• اضغط على Sync Now في أعلى يمين الشاشة لتحميل المكتبة.

الخطوة الثالثة تجهيز واجهة المستخدم (XML) :

افتح ملف تصميم الواجهة الخاص بالشاشة التي ستعرض الكتاب وأضف عنصر PDFView:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.github.barteksc.pdfviewer.PDFView
        android:id="@+id/pdfView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</RelativeLayout>

الخطوة الرابعة كتابة الكود البرمجي لتشغيل الكتاب :

الآن سنقوم بربط الواجهة بملف الـ PDF الموجود في مجلد assets.

لا يوجد عنصر  جاهز ومدمج مباشرة لقراءة ملفات PDF. لذلك، الطريقة الأفضل والأكثر شيوعاً هي استخدام مكتبة خارجية مثل  AndroidPdfViewer. وفي الرابط التالي الخطوات المطلوبة لاستخدامها 

https://github.com/DImuthuUpe/AndroidPdfViewer

ويفضل استخدام ـ Firebase Storage لتخزين ملفات PDF، وFirebase Firestore لتخزين بيانات الكتب (الاسم، المؤلف، الغلاف، رابط PDF). هكذا تستطيع إضافة كتب جديدة دون تحديث التطبيق.