Flutter_tex 项目安装与配置指南

2025-04-17 13:39:25作者：俞予舒Fleming

1. 项目基础介绍

flutter_tex 是一个开源的 Flutter 包，它允许开发者使用 LaTeX、TeX 和 MathML 语言在 Flutter 应用中渲染数学、物理和化学方程。这个包完全离线工作，支持 HTML 和 JavaScript，使得在 Flutter 应用中添加复杂的科学文档和表达式变得简单。

主要编程语言：Dart

2. 项目使用的关键技术和框架

Flutter: 用于构建用户界面的开源框架。
LaTeX: 一个高质量排版系统，常用于生成科学和数学文档。
MathJax: 一个强大的 JavaScript 库，用于在网页上渲染数学公式。

3. 项目安装和配置的准备工作

在开始之前，请确保您的开发环境已经安装了以下内容：

Flutter SDK
Dart
一个合适的 IDE（例如 Android Studio 或 VS Code）

安装步骤

步骤 1: 添加依赖

首先，您需要在您的 Flutter 项目的 pubspec.yaml 文件中添加 flutter_tex 包作为依赖。

dependencies:
  flutter_tex:
    ^4.1.3

然后，在命令行中运行以下命令以获取包：

flutter packages get

步骤 2: 配置 Android

对于 Android 平台，您需要在 AndroidManifest.xml 文件中添加以下权限，位于 <application> 标签内：

<application
    ...
    android:usesCleartextTraffic="true">
    ...
</application>

此外，还需要在 <queries> 标签中添加以下意图：

<queries>
    ...
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="https" />
    </intent>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="sms" />
    </intent>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="tel" />
    </intent>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="mailto" />
    </intent>
    <intent>
        <action android:name="android.support.customtabs.action.CustomTabsService" />
    </intent>
</queries>

步骤 3: 配置 iOS

对于 iOS 平台，您需要在 Info.plist 文件中添加以下配置：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>
<key>io.flutter.embedded_views_preview</key>
<true/>
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
    <string>http</string>
    <string>tel</string>
    <string>mailto</string>
</array>

步骤 4: 配置 Web

对于 Web 支持，您需要在 web/index.html 文件的 <head> 标签中添加以下脚本：

<script src="assets/packages/flutter_tex/js/flutter_tex.js"></script>
<script type="text/javascript">window.flutterWebRenderer = "canvaskit";</script>

步骤 5: 使用前准备

在 Dart 代码中使用 flutter_tex 之前，如果您不是在 Web 环境下，需要先启动 TeX 渲染服务：

if (!kIsWeb) {
  await TeXRenderingServer.start();
}

以上步骤完成之后，您就可以在 Flutter 应用中使用 flutter_tex 包来渲染 LaTeX、TeX 和 MathML 表达式了。

登录后查看全文