FontProvider 项目常见问题解决方案

FontProvider 项目常见问题解决方案

FontProvider Provide NotoCJK (and other) fonts to other app. 项目地址: https://gitcode.com/gh_mirrors/fo/FontProvider

1. 项目基础介绍

FontProvider 是一个开源项目，旨在为 Android 应用提供多种字重（特别是 NotoCJK 字体）的支持。在大多数 Android 系统中，CJK 字体只提供一个字重，而英语字体 Roboto 提供多达 7 个字重，这导致了在不同语言环境下界面显示效果的差异。FontProvider 的出现解决了这一问题，使得 Android 应用能够支持更多字重的 CJK 字体，从而改善用户界面显示效果。该项目主要使用 Java 和 Kotlin 编程语言。

2. 新手常见问题及解决步骤

问题一：如何将 FontProvider 集成到 Android 项目中？

解决步骤：

1. 在项目的 build.gradle 文件中添加依赖：

   implementation 'moe.shizuku.fontprovider:api:<版本号>'
   

   请将 <版本号> 替换为实际的版本号。

2. 如果使用的 gradle 插件版本在 3.0.0 之前，需要将 implementation 替换为 compile。

3. 确保项目的 build.gradle 文件配置正确，并同步项目。

问题二：为什么我的应用在使用 FontProvider 后没有看到字体变化？

解决步骤：

1. 确保 FontProvider 已经正确集成到项目中，并且依赖配置正确。

2. 检查应用是否已经适配了 Font Provider。在 Activity 的 onCreate 方法中初始化 FontProvider：

   if (!sFontInitialized) {
       FontProviderClient client = FontProviderClient.create(this);
       if (client != null) {
           client.setNextRequestReplaceFallbackFonts(true);
           client.replace("Noto Sans CJK", "sans-serif", "sans-serif-medium");
       }
       sFontInitialized = true;
   }
   

3. 确认应用中使用的字体名称是否正确，并且与 FontProvider 中提供的字体相匹配。

问题三：如何处理 Android 7.0 以下系统中的存储权限问题？

解决步骤：

1. 由于 API 限制，在 Android 7.0 以下系统使用 Font Provider 需要申请存储权限。

2. 在项目的 AndroidManifest.xml 文件中添加以下权限申请：

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

3. 在应用运行时动态申请存储权限，以确保兼容性：

   if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
       // 动态申请存储权限
       ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_CODE);
   }
   

通过遵循以上步骤，新手开发者可以更好地集成和使用 FontProvider，解决在使用过程中可能遇到的常见问题。

FontProvider Provide NotoCJK (and other) fonts to other app. 项目地址: https://gitcode.com/gh_mirrors/fo/FontProvider