mirror of https://github.com/Tencent/Hippy.git synced 2026-10-18 13:40:41 +08:00

Files

T

siguangli 4ac996692f Feat/3.0 upgrade guidelines (#3805 )

* refactor(docs): update 3.0 upgrade guidelines

* refactor(docs): update iOS 3.0 upgrade guidelines

---------

Co-authored-by: maxli <maxli@tencent.com>

2024-04-01 20:59:34 +08:00

3.4 KiB

Raw Permalink Blame History

Voltron Flutter 集成指引

这篇教程，讲述了如何将 Hippy 3.x SDK 集成到 Flutter 工程。

注：以下文档都是假设您已经具备一定的 Flutter 开发经验。

前期准备

已经安装了 Flutter version>=3.0 并配置了环境变量

Demo 体验

若想快速体验，可以直接基于我们的 Voltron Demo 来开发，我们提供以下两种 Demo

如果您的应用完全通过 Flutter 进行开发，可以参考flutter_proj，3.0正式发布前，请使用 flutter_proj
如果您希望将 Voltron 集成进您的原生 IOS 或 Android 应用，可以使用 flutter module 进行集成
- Android 应用请参考android-proj，3.0正式发布前，请使用 flutter_proj
- IOS 应用请参考IOSProj，3.0正式发布前，请使用 flutter_proj

注意，使用 flutter_module 方式进行开发时，原生工程和 Flutter 工程在两个目录，上面所提到的 android-proj 和 IOSProj 均需要配合 flutter_module进行使用，3.0正式发布前，请使用 flutter_proj

快速接入

如果您的应用完全通过 `Flutter` 进行开发

创建一个 Flutter 工程
Pub 集成

在 pubspec.yaml 中添加 Voltron 依赖
```
dependencies:
  voltron: ^0.0.1
```
本地集成（可选）
1. 克隆 Hippy 源码
```
git clone https://github.com/Tencent/Hippy.git
```
  注意使用相应的分支及tag，未合入主干前，请使用v3.0-dev分支
2. 打开 Flutter 工程根目录下的 pubspec.yaml
  
  在 dependencies 下添加 voltron 依赖
```
voltron:
  path: Hippy路径/framework/voltron
```
安装依赖
```
flutter pub get
```
使用 Voltron

建议参考flutter_proj，3.0正式发布前，请使用 flutter_proj

Pub 集成方式在 Android 平台默认支持 arm64-v8a 和 armeabi-v7a，如需支持 x86 和 x86_64，请使用本地集成，iOS 无影响。

需要注意，如果 debugMode 为YES的情况下，会忽略所有参数，直接使用 npm 本地服务加载测试 bundle，

如果您希望将 `Voltron` 集成进您的原生 `IOS` 或 `Android` 应用

使用该方式进行集成时，要首先集成 Flutter Module，该部分可直接参考官网Add Flutter to an existing app
后续流程与完全通过 Flutter 进行开发保持一致即可。也可直接参考我们的Demo工程

3.4 KiB Raw Permalink Blame History Unescape Escape