ijkplayer编译so库真没那么难

ijkplayer编译so库真没那么难

---

引言：

公司现在的电台项目是我第二个接触音频播放项目，Android音视频
播放很多还是使用的MediaPlayer(大中厂除外)，但是如果你用过
MediaPlayer的话，很多开发者都会吐槽有多坑，连谷歌官方都推荐
使用ExoPlayer…遇到过最坑的就是播放在线音视频的时候，网络不好
会一直加载，然后点多了还容易ANR…以前就一直想把音频播放这个
换掉，通过自行搜索和问别人，又下面几个方案(小作坊不可能
另外去写个编解码播放库)：

• ExoPlayer：Demo复杂得一匹…而且网上的资料也不是很多，pass;
• Vitamio：自用免费，商用收费，直接就pass了;
• 自己编译ffmpeg：一听就很复杂的，同样Pass；
• ijkplayer：大B站开源的基于FFmpeg的轻量级
  Android/iOS视频播放器，网上资料挺多的，而且官方
  也有维护，虽然还有1600多个issues，和mediaplayer
  差不多的接口，学习成本也不高，可以加进来试试水！

最后就决定使用ijkplayer来替换原先的MediaPlayer了！

---

1.如何使用ijkplayer

官方：https://github.com/Bilibili/ijkplayer

build.gradle添加下述依赖引用即可：

dependencies {
    # 对于大部分的设备来说已经够用了
    compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.4'
    compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.4'

    # Other ABIs: 可选
    compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.4'
    compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.4'
    compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.4'
    compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.4'

    # ExoPlayer as IMediaPlayer: optional, experimental
    compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.4'
}

这里简单说点东西来解除你可能存在的一些疑惑：

armv7a，armv5，arm64，x86，x86_64 这些是对应的CPU架构，
一般来说准备一个armv7a就基本够了，如果系统找不到CPU架构
对应的so库会去找armeabi，多依赖一些架构只是稍微会快一点，
但是这样也伴随着apk体积的增大，这个需要你自行去权衡！！！
反正笔者就只有一个：armv7a，暂时没发现什么不服！

然后使用方法和MediaPlayer大同小异，这就不另外讲述怎么
使用了，网上一搜也很多。接下来要说下笔者遇到的一个问题：

ijkplayer默认不支持HTTPS

是的，不支持，如果你尝试使用ijkplayer播放Https开头的音频，会报这样的错误：

除了去编译ijkplayer的源码，没有其他选择，编译这玩意可把我
坑惨了，各种不懂，碰壁，不过最后所幸还是捣鼓成功了，顺道
记录下，方便后来者(顺道吐槽下网上各种抄的文章，搜到的基本
都是一样的…)

---

2.编译支持Https的ijkplayer

不要问我Windows上怎么编译，反正我只会Ubuntu和MAC上编译！
笔者在Ubuntu 14.04 和 MAC OS 10.13 上都编译成功了，
在使用Ubuntu编译的时候有个坑要注意：

不要把项目克隆到外部硬盘，比如我电脑120G的SSD
还挂了一个1T的机械硬盘，一开始就clone到机械硬盘上了，然后编译
一堆问题，什么ln无法建立链接，chmod命令无效之类的，没把我给毒死，
后面clone到SSD 上一点毛病也没有，全程绿灯！

---

• Step 1：安装Git与yasm：

sudo apt-get install git
sudo apt-get install yasm

---

• Step 2：下载，配置SDK与NDK

sdk就不说了，你开发安卓肯定会有的，NDK一般是不默认下载的，
这里也不建议你使用SDK Manager下载的NDK，之前试过有些许问题，
建议去官网下载：https://developer.android.google.cn/ndk/downloads/index.html
NDK的最小版本支持是10e，目前不支持NDK 15！

接着是配置环境变量：

Ubuntu：

设置修改下：.bashrc文件，把SDK和NDK配置上：

然后source .bashrc，键入ndk-build -v 看有没有东西输出
验证配置是否生效。

MAC：

打开终端，cd到根目录(cd ~)，然后新建一个.bash_profile的文件：
进行如下配置

然后输入source .bash_profile，键入ndk-build -v 验证：

---

• Step 3：拉取ijkplayer源码

git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android
cd ijkplayer-android
git checkout -B latest k0.8.4

---

• Step 4：初始化android

./init-android.sh

---

• Step 5：编译脚本配置

就是自动化编译时的一些配置选项，比如支持什么协议啊，支持什么音视频类型等，
这个配置文件是：config/module.sh，你喜欢可以打开看看这个文件：
比如这里是配置处理什么类型的数据的，enable启用，disable禁用。

另外官方给我们提供了三个模板给我们使用：

module-default.sh：默认，如果你喜欢更多类型可以用这个；
module-lite-hevc.sh：如果您更喜欢较小的二进制大小的编解码器/格式（包括hevc功能）
module-lite.sh：如果您更喜欢较小的二进制大小的编解码器/格式（默认情况下）

反正体积最小，就用module-lite.sh这个就行了，使用也很简单：

rm module.sh
ln -s module-lite.sh module.sh
source module.sh

到此你还可以打开module.sh自行进行修改，比如我只想它支持mp3，
其他格式都不支持，那么可以把不想支持的格式的enable改成disable。

---

• Step 6：初始化android支持Https

cd ..
./init-android-openssl.sh

注：如果出现NDK或者SDK找不到，可以执行一下source ~/.bash_profile

---

• Step 7：清除一波

cd android/contrib
./compile-openssl.sh clean
./compile-ffmpeg.sh clean

---

• Step 8：编译openssl

./compile-openssl.sh all

---

• Step 9：编译ffmpeg

这里的话看你需要，如果想编译所有版本的so库，就跟all，如果是特定
CPU架构就跟cpu架构，比如：./compile-ffmpeg.sh armv7a
编译特定需要的肯定是比全部耗时短~

./compile-ffmpeg.sh all

---

• Step 10：编译ijkplayer

加all默认编译所有架构的so库，不加默认只编译armv7a架构！

./compile-ijk.sh all

---

编译需要漫长的等待，编译成功后，会在目录下生成一个ijkplayer的工程：

到此，编译一个支持HTTPS的ijkplayer就完成了，接着是怎么用这个东西啦：

再吐槽一句：网上很多教编译的，到此就完了，完全不跟别人说怎么用，
我一开始以为只要把so库放到自己项目的libs下就可以了，结果各种编译
报错，我真服了，大佬们写文章别虎头蛇尾啊！！！

最简单的使用方法，就是把这个项目当成一个library导入到项目中，
就是build.gradle里多一个compile project(‘:ijkplayer’)，
然后你就可以用了，记得把你之前写的：

compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.4'
compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.4'

这些依赖删掉，不然还是会报不支持HTTPS的！
一般到这里引用到项目里就够了，但是小猪不是个容易满足的人！
所以有了下面的折腾！

---

3.删减无关东西，生成aar依赖库

觉得又很多无关的东西，说下小猪的期望吧：

• 1.只是用来播放音乐(exo和example部分可以去掉)；
• 2.只需要armv7a架构的(删除其他架构，并把armv7a的so库放到ijkplayer-java)；
• 3.最后只保留一个ijkplayer-java，导出成ijkplayer.aar文件供自己的项目使用；

接着一步步来把实现小猪的期望吧：

---

• Step 1：右键项目 Open Module Settings，点击减号把除了ijkplayer-example
  和ijkplayer-java的依赖都删除：

接着打开ijkplayer-java/src/main/，新建一个libs文件夹,
同时打开ijkplayer-armv7a/main/libs，把里面的armeabi-v7a文件
夹整个拷到ijkplayer-java的libs文件夹下。

然后可以把除了ijkplayer-example和ijkplayer-java的其他都删掉了，
接着修改下ijkplayer-java的build.gradle文件，删掉最后一句，以及
修改下版本信息。

接着编译一波整个工程，运行下，点开simple，随便点首歌看看能否播放，
如果可以正常播放，那么就进入下一步了，导出aar库。

---

• Step 2：编译aar库

这个倒是简单，点击右侧gradle，依次打开，右键run就好

执行完毕，会在build/outputs/aar目录下生成aar文件。

---

• Step 3：把aar文件添加到项目中

这个也很简单，直接丢到app的libs文件夹下，然后build.gradle
下添加依赖，(笔者直接把ijkplayer-java-release.aar改名成
ijkplayer.aar)

implementation(name: 'ijkplayer', ext: 'aar')

接着，项目里写个简单的播放音乐的代码试试水，按钮点击播放一个音乐：

public class MusicPlayActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_music_play);
        Button btn = findViewById(R.id.button);
        btn.setOnClickListener(v -> {
            IjkMediaPlayer player = new IjkMediaPlayer();
            player.setAudioStreamType(AudioManager.STREAM_MUSIC);
            player.setScreenOnWhilePlaying(true);
            player.setOnPreparedListener(IMediaPlayer::start);
            try {
                player.setDataSource("https:xxxx.mp3");
                player.prepareAsync();
            } catch (IOException e) {
                e.printStackTrace();
            }
        });
    }
}

如果播放正常的话，说明我们的移植非常成功，如果你没有用模块化，
到此就可以结束了，如果你像我一样用了模块化，而且还把音频播放
独立成了一个模块，app -> 音频播放模块 -> ijkplayer.aar，
恭喜你，编译直接报错，找不到aar，2333！解决方法的话，你要
接着看下面的啦~

---

4.模块化，模块使用aar找不到问题解决

需要修改三个build.gradle文件，依次是音频播放模块，app，以及application层级

音频播放模块的build.gradle：

app层级的build.gradle：

application层级的build.gradle

接着build一波项目，就可以啦~

---

小结

耗时几天，总算是编译成功，而且收获颇多了，也懂了了一个道理：
人难免有畏难情绪，对于学习新的东西总会下意识的抗拒，觉得难，
但是大部分时候只是看上去难，当你去学了，并坚持一段时间，你
会发现，其实并没有你想象中那么难~

最后附上缩减后的ijk-player和aar包，有需要的自取：
https://github.com/coder-pig/ijkplayer

---