GrapheneOS PdfViewer 开源项目教程

GrapheneOS PdfViewer 开源项目教程

PdfViewerSimple Android PDF viewer based on pdf.js and content providers. The app doesn't require any permissions. The PDF stream is fed into the sandboxed WebView without giving it access to content or files. CSP is used to enforce that the JavaScript and styling properties within the WebView are entirely static.项目地址:https://gitcode.com/gh_mirrors/pd/PdfViewer

1. 项目的目录结构及介绍

GrapheneOS PdfViewer 项目的目录结构如下：

PdfViewer/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── pdfviewer/
│   │   │   │           ├── MainActivity.kt
│   │   │   │           └── ...
│   │   │   ├── res/
│   │   │   │   ├── drawable/
│   │   │   │   ├── layout/
│   │   │   │   ├── mipmap/
│   │   │   │   └── values/
│   │   │   └── AndroidManifest.xml
│   ├── build.gradle
│   └── ...
├── gradle/
├── build.gradle
├── settings.gradle
└── ...

目录结构介绍

• app/: 包含应用程序的主要代码和资源。
  • src/: 源代码目录。
    • main/: 主源代码目录。
      • java/: Kotlin 源代码目录。
        • com/pdfviewer/: 应用程序的主要包。
          • MainActivity.kt: 应用程序的主活动文件。
      • res/: 资源目录。
        • drawable/: 图片资源。
        • layout/: 布局文件。
        • mipmap/: 应用图标。
        • values/: 字符串和其他值资源。
      • AndroidManifest.xml: 应用程序的清单文件。
  • build.gradle: 应用程序的构建脚本。
• gradle/: Gradle 相关文件。
• build.gradle: 项目的构建脚本。
• settings.gradle: 项目的设置文件。

2. 项目的启动文件介绍

项目的启动文件是 MainActivity.kt，位于 app/src/main/java/com/pdfviewer/ 目录下。这个文件是应用程序的主活动，负责启动应用程序并加载主界面。

MainActivity.kt 文件内容简介

package com.pdfviewer

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }
}

• package com.pdfviewer: 定义了文件的包名。
• import ...: 导入了必要的类和库。
• class MainActivity : AppCompatActivity(): 定义了主活动类，继承自 AppCompatActivity。
• override fun onCreate(savedInstanceState: Bundle?): 重写了 onCreate 方法，设置布局文件 activity_main。

3. 项目的配置文件介绍

项目的配置文件主要包括 build.gradle 和 AndroidManifest.xml。

build.gradle 文件

build.gradle 文件位于 app/ 目录下，负责配置应用程序的构建过程。

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

android {
    compileSdk 30

    defaultConfig {
        applicationId "com.pdfviewer"
        minSdk 21
        targetSdk 30
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.core:core-ktx:1.3.2'
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.material:material:1.3.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
}

• plugins: 定义了使用的插件。
• android: 配置 Android 构建选项。
  • compileSdk: 编译 SDK 版本。
  • defaultConfig: 默认配置，包括应用 ID、最小 SDK 版本、

PdfViewerSimple Android PDF viewer based on pdf.js and content providers. The app doesn't require any permissions. The PDF stream is fed into the sandboxed WebView without giving it access to content or files. CSP is used to enforce that the JavaScript and styling properties within the WebView are entirely static.项目地址:https://gitcode.com/gh_mirrors/pd/PdfViewer