neomantra/flatbuffers

docker-flatbuffers - FlatBuffers的Docker工具

![构建状态]([***]

docker-flatbuffers是https://google.github.io/flatbuffers/%E7%9A%84Docker%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://github.com/neomantra/docker-flatbuffers%E3%80%82%E5%AE%83%E5%8C%85%E5%90%ABFlatBuffers%E7%9A%84%60flatc%60%E5%B7%A5%E5%85%B7%E5%8F%8A%E9%80%9A%E8%BF%87https://github.com/dvidelabs/flatcc%E6%8F%90%E4%BE%9B%E7%9A%84C%E8%AF%AD%E8%A8%80%E6%94%AF%E6%8C%81%E3%80%82%E6%97%A0%E9%9C%80%E6%9C%AC%E5%9C%B0%E5%AE%89%E8%A3%85FlatBuffers%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E8%BF%90%E8%A1%8C%60flatc%60%E6%88%96%60flatcc%60%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87%22%E7%BB%91%E5%AE%9A%E6%8C%82%E8%BD%BD%22%E6%8C%82%E8%BD%BD%E8%BE%93%E5%85%A5%E8%BE%93%E5%87%BA%E7%9B%AE%E5%BD%95%EF%BC%88%E8%AF%A6%E8%A7%81%E4%BD%9C%E4%B8%BA%E6%9E%84%E5%BB%BA%E5%B7%A5%E5%85%B7%E4%BD%BF%E7%94%A8%EF%BC%89%EF%BC%9A

docker run -v /proj/src:/src -v /proj/dest:/dest neomantra/flatbuffers flatc --cpp --js --ruby -o /dest /src/monster.fbs

支持的标签

镜像提供gcc和clang两种变体，分别对应使用GCC和Clang工具链构建的FlatBuffers。未指定变体的标签默认使用gcc。"master"分支镜像标签为构建日期的YYYYMMDD格式。

特定FlatBuffers/flatc和flatcc版本以版本名作为标签，flatc版本前缀为v，flatcc版本前缀为cc：

• gcc、latest
• clang
• gcc-v1.8.0、v1.8.0
• clang-v1.8.0
• gcc-v1.8.0-cc0.5.1

镜像构建由Travis-CI管理。为保证稳定性，建议固定使用完整标签，例如neomantra/flatbuffers:gcc-v1.8.0-cc0.5.1。

目录

• 支持的标签
• 作为镜像构建阶段使用
• 作为构建工具使用
• 镜像中的文件
• 自定义Docker镜像构建
• 作者
• 版权与许可

作为镜像构建阶段使用

可通过以下Dockerfile指令从该镜像复制文件到自定义镜像中。根据项目需求选择合适的镜像、标签和文件（文件列表见镜像中的文件）：

dockerfile
COPY --from=neomantra/flatbuffers /usr/local/bin/flatc /usr/local/bin/flatc
COPY --from=neomantra/flatbuffers /usr/local/include/flatbuffers /usr/local/include/flatbuffers
COPY --from=neomantra/flatbuffers /usr/local/lib/libflatbuffers.a /usr/local/lib/libflatbuffers.a
COPY --from=neomantra/flatbuffers /usr/local/lib/cmake/flatbuffers /usr/local/lib/cmake/flatbuffers


COPY --from=neomantra/flatbuffers /usr/local/bin/flatcc /usr/local/bin/flatcc
COPY --from=neomantra/flatbuffers /usr/local/include/flatcc /usr/local/include/flatcc
COPY --from=neomantra/flatbuffers /usr/local/lib/libflatcc.a /usr/local/lib/libflatccrt.a /usr/local/lib/

作为构建工具使用

通过卷绑定挂载可在主机生成文件：将主机的源目录挂载到容器，调用flatc处理其中的模式文件，并将输出写入挂载的目标目录。

示例：

bash
# 主机输入目录为/my/src
# 输出写入到/my/dest
docker run -v /my/src:/src -v /my/dest:/dest neomantra/flatbuffers flatc --cpp --scoped-enums -o /dest /src/monster.fbs

镜像中的文件

该镜像基于debian-slimhttps://hub.docker.com/_/debian/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%ABFlatBuffers%E5%92%8Cflatcc%E7%9A%84%E6%9E%84%E5%BB%BA%E4%BA%A7%E7%89%A9%EF%BC%8C%E7%BB%93%E6%9E%84%E7%B2%BE%E7%AE%80%EF%BC%9A

FlatBuffers

/usr/local/bin/flatc

/usr/local/include/flatbuffers
/usr/local/include/flatbuffers/idl.h
/usr/local/include/flatbuffers/registry.h
/usr/local/include/flatbuffers/reflection.h
/usr/local/include/flatbuffers/flexbuffers.h
/usr/local/include/flatbuffers/flatc.h
/usr/local/include/flatbuffers/minireflect.h
/usr/local/include/flatbuffers/base.h
/usr/local/include/flatbuffers/grpc.h
/usr/local/include/flatbuffers/flatbuffers.h
/usr/local/include/flatbuffers/reflection_generated.h
/usr/local/include/flatbuffers/hash.h
/usr/local/include/flatbuffers/stl_emulation.h
/usr/local/include/flatbuffers/util.h
/usr/local/include/flatbuffers/code_generators.h

/usr/local/include/flatbuffers/idl_parser.cpp
/usr/local/include/flatbuffers/idl_gen_text.cpp

/usr/local/lib/libflatbuffers.a

/usr/local/lib/cmake/flatbuffers/FlatbuffersConfig.cmake
/usr/local/lib/cmake/flatbuffers/FlatbuffersConfigVersion.cmake
/usr/local/lib/cmake/flatbuffers/FlatbuffersTargets.cmake
/usr/local/lib/cmake/flatbuffers/FlatbuffersTargets-release.cmake
/usr/local/lib/cmake/flatbuffers/FlatcTargets.cmake
/usr/local/lib/cmake/flatbuffers/FlatcTargets-release.cmake

flatcc

# 编译器：
/usr/local/bin/flatcc
/usr/local/lib/lib/libflatcc.a
/usr/local/include/flatcc/flatcc.h

# 运行时：
/usr/local/include/include/flatcc
/usr/local/include/include/flatcc/reflection
/usr/local/include/include/flatcc/support
/usr/local/lib/libflatccrt.a

自定义Docker镜像构建

可通过以下构建参数自定义镜像构建，使用--build-arg <参数>=<值>传递给docker build命令：

作者

此工具由Evan Wies创建，由Neomantra赞助。

镜像构建资源由Travis CI赞助，确保软件的透明生产和分发。

版权与许可

本软件采用MIT许可证发布。

版权所有 (c) 2018-2021，Neomantra BV 和 Evan Wies <***>

特此授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人免费许可，允许其不受限制地处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并允许向其提供软件的人这样做，但须满足以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件使用或其他交易引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他形式。