libuv

---

基本介绍

1. 本工程是 libuv 及其 C 示例的构建工程，用于运行调试
2. 所有 libuv 源码来自libuv 官方1.31.0 版本
3. 仅保留 Mac/Linux/Win 三个平台的源码，去除了其他平台特定代码（为了足够简单）
4. 增加了源码注释，支持 Debug/Release 编译模式
5. 整个工程 PC 端编译构建采用 cmake 来管理，支持跨平台（可以在树莓派上正常 cmake+make）

---

如何编译

1. 在 Mac 上采用 Xcode 编译

cd libuv/
mkdir buildXcode && cd buildXcode
cmake -DCMAKE_INSTALL_PREFIX=./install -G "Xcode" ..
# cmake -DCMAKE_INSTALL_PREFIX=/usr/local/zyk/libuv -G "Xcode" ..

此时已经在 buildXcode 文件夹下生成了 Xcode 工程，直接打开并编译即可

2. 直接命令行编译（支持 Mac 和 Linux）

cd libuv/
mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=./install .. # default is Debug
# for Debug: cmake -DCMAKE_BUILD_TYPE=Debug ..
# for Release: cmake -DCMAKE_BUILD_TYPE=Release ..
# cmake -DCMAKE_INSTALL_PREFIX=/usr/local/zyk/libuv -DCMAKE_BUILD_TYPE=Release ..
make
# for more details: make VERBOSE=1
make install

make 命令会自动编译好各个模块

3. 在 Windows 上使用 Cygwin + Visual Studio 2017 进行编译

cd libuv/
mkdir buildVS && cd buildVS
cmake -DCMAKE_INSTALL_PREFIX=./install -G "Visual Studio 15 2017 Win64" ..
# cmake -DCMAKE_INSTALL_PREFIX=D:/Applications/zyk/libuv -G "Visual Studio 15 2017 Win64" ..

此时已经在 buildVS 文件夹下生成了 Visual Studio 工程，双击打开并编译即可

4. 在 Mac 上编译出用于 iOS 的 libuv.a 静态库

cd libuv/libuv/iOS
open uv.xcodeproj

编译该 iOS Xcode 工程即可得到 libuv.a 库

5. 使用 NDK 编译出用于 Android 的 libuv.so 共享库

cd libuv/libuv/Android/
ndk-build
ndk-build clean # clean project
ndk-build -B # rebuild project

编译之后便会有 libuv/libuv/Android/libs/${APP_ABI}/libuv.so 共享库

使用 ndk-build 命令需要先安装 AndroidStudio+AndroidSDK+NDK，然后将 ndk-bundle 路径加到系统 PATH 环境变量中

---

文件夹说明

1. demo：libuv 源码中相关组件的用法示例，以及其他应用构建
2. docs：libuv 官方文档
3. example：libuv 官方源码中附带的用法示例，做了一些小修改
4. libuv：libuv 官方源码，加了注释，编译出 libuv 动态链接库

问题记录

1. libuv 在 Android 平台上仅支持 AndroidAPI21 及以上的 SDK
2. 错误码转字符串的函数中，遇到 unknown 的错误码会 malloc 一段内存在存放该错误字符串，这会造成少量内存泄漏，libuv 官方文档也有提及，这里将其改为返回固定字符串，防止内存泄漏