ponylang/ponyc

ponylang/ponyc Docker镜像文档

镜像概述

ponylang/ponyc是Pony语言编译器的Docker镜像，基于Pony源代码仓库的最新提交自动构建。该镜像提供了一个无需本地配置依赖即可编译和运行Pony程序的环境，适用于Pony语言的开发、测试和快速验证场景。

核心功能与特性

• 便捷编译：无需在本地安装Pony编译器及依赖（如LLVM），直接通过Docker容器编译Pony程序
• 最新版本：镜像随Pony源代码仓库master分支的提交自动更新，确保使用最新功能
• 跨平台支持：可在任何支持Docker的操作系统（Linux、Windows、macOS）上使用
• 简单集成：支持将本地代码目录挂载到容器中，实现代码的实时编译和运行

使用场景

• 快速测试Pony代码片段或小型项目
• 在不污染本地环境的情况下学习和开发Pony程序
• 跨平台验证Pony程序的编译和运行结果
• 集成到CI/CD流程中，作为Pony项目的编译环境

使用方法

前提条件

已安装Docker引擎，具体安装步骤参考https://docs.docker.com/engine/installation/%E3%80%82

拉取镜像

bash
docker pull ponylang/ponyc:latest

编译Pony程序

将本地Pony代码目录挂载到容器的/src/main目录，执行编译命令：

bash
docker run -v /path/to/your-code:/src/main ponylang/ponyc

注意：

• /path/to/your-code必须是绝对路径，不能使用相对路径
• 路径末尾不要添加斜杠/

运行编译后的程序

编译生成可执行文件后，可在容器中直接运行：

bash
docker run -v /path/to/your-code:/src/main ponylang/ponyc ./main

Windows系统使用

1. 首先确保已在Docker for Windows中共享本地驱动器（如C:），参考https://docs.docker.com/docker-for-windows/#shared-drives

2. 拉取镜像：

   bash
   docker pull ponylang/ponyc:latest
   

3. 编译程序（以C:盘为例）：

   bash
   docker run -v c:/path/to/your-code:/src/main ponylang/ponyc
   

4. 运行程序：

   bash
   docker run -v c:/path/to/your-code:/src/main ponylang/ponyc ./main
   

5. 编译并运行一步完成：

   bash
   docker run -v c:/path/to/your-code:/src/main ponylang/ponyc sh -c "ponyc && ./main"
   

注意事项

AVX2支持

默认情况下，Pony Docker镜像未启用对AVX CPU指令的支持。若需在现代硬件上获得最佳性能，建议从源代码构建Pony编译器。

Docker Machine兼容性

如果使用docker-machine而非原生Docker，需确保使用的VirtualBox版本与Docker兼容，避免出现运行问题。

32位平台支持

Pony对32位平台（如arm和armhf架构）仅提供部分支持，具体兼容性可参考https://circleci.com/gh/ponylang/ponyc%E3%80%82