---
title: 安装
permalink: /docs/zh/install.html
key: docs-install-zh
---


fijkplayer 是 ijkplayer 的 Flutter 封装， 是一款支持 android 和 iOS 的 Flutter 媒体播放器插件，
由 [ijkplayer](https://github.com/befovy/ijkplayer) 底层驱动。  
通过纹理（Texture）接入播放器视频渲染到 Flutter 中。  

让我们开始使用 fijkplayer 构建你的 Flutter 音视频应用之旅！  
别担心，只需要掌握很少的知识你就能完成 Flutter 音视频应用的开发。

本节内容包括简洁安装指南以及详细安装指南。

## 简洁安装指南

在 flutter 项目配置文件 `pubspec.yaml` 中加入 `fijkplayer` 依赖。最新的稳定版本号见 badge 图标。

```yaml
dependencies:
  fijkplayer: ^0.1.10
```

[![pub package](https://img.shields.io/pub/v/fijkplayer.svg)](https://pub.dartlang.org/packages/fijkplayer) &nbsp; &nbsp;
[![Build Status](https://travis-ci.org/befovy/fijkplayer.svg?branch=master)](https://travis-ci.org/befovy/fijkplayer) &nbsp; &nbsp; 

如果需要使用某些尚未发布的功能更新，可以直接依赖对应的 git 分支，方式如下。
比如这里依赖 develop 分支，
```yaml
dependencies:
  fijkplayer:
    git:
      url: https://github.com/befovy/fijkplayer.git
      ref: develop
```

## 详细安装步骤

如果你熟悉 Flutter App 的依赖安装，看上面 “简洁安装指南” 就够了，本页后续内容完全可以跳过。


如果你不太熟悉 Flutter App 开发流程，看到了这这一部分内容，我们还是假定你已经在你的设备上配置好了 Flutter 的开发环境。即你可以在命令行输入 `flutter` 命令，并且有相应的正确输出内容。


### 新建 Flutter App 项目


终端输入以下命令，新建一个名为 `playerapp` 的 Flutter App 项目。
```
$ flutter create -t app playerapp
```
命令运行结束后，Flutter 会给我们如下提示。
```
In order to run your application, type:

  $ cd playerapp
  $ flutter run

Your application code is in playerapp/lib/main.dart.
```


连接上手机设备（或者打开 Android 模拟器），并且使用 `flutter doctor` 命令检查设备是否连接成功。


```
$ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, v1.7.8+hotfix.4, on Mac OS X 10.14.3 18D109, locale zh-Hans-CN)

[✓] Android toolchain - develop for Android devices (Android SDK version 28.0.3)
[✓] Xcode - develop for iOS and macOS (Xcode 10.3)
[✓] iOS tools - develop for iOS devices
[✓] Android Studio (version 3.4)
[✓] IntelliJ IDEA Ultimate Edition (version 2019.1.2)
[✓] VS Code (version 1.36.1)
[✓] Connected device (1 available)

• No issues found!
```

在 `flutter doctor` 命令的输出中，至少应该含有 `[✓] Connected device (1 available)`


### 安装 fijkplayer 依赖

进入上一步中创建的目录 playerapp 中，编辑其中的文件 `pubspec.yaml` ，增加依赖 `fijkplayer: ^0.1.10`

```diff
dependencies:
  flutter:
    sdk: flutter
    
+ fijkplayer: ^0.1.10
```

然后在 playerapp 目录中运行如下命令安装依赖，等待命令成功完成。

```
$ flutter pub get --verbose
```


### 验证依赖安装

安装完 fijkplayer 之后我们先验证一下，确保安装正确。

编辑 `lib/main.dart` 文件，在开头加入如下行，引入 fijkplayer。
```dart
import 'package:fijkplayer/fijkplayer.dart';
```

然后分别编译 ios 和 android 项目，确保 build 成功

```
$ flutter build apk
$ flutter build ios --no-codesign
```

#### **注意事项**
* fijkplayer 中使用了 androidx 的 support 库，在 app 中需要启用 androidx
* 如果 build apk 时太久时间没有输出，可以先在 android 目录运行 `./gradlew` 检查 gradle 环境是否正确。
* pod install 安装依赖需要从 github 下载底层 ijkplayer 的二进制文件，如果网不好可能会很慢。  
  建议在 ios 文件夹中运行 `pod install --verbose` 查看实时下载进度。

Flutter 中安装 fijkplayer 的内容到这里就结束了，有任何问题请在 [github issues](https://github.com/befovy/fijkplayer/issues) 中进行提问。    
下一节就是要写一个 hello world 播放器程序了。👏
