balenalib IoT设备基础镜像（OpenJDK版）

镜像概述

该镜像属于balena.io IoT设备基础镜像系列，专为物联网设备开发优化。它主要设计用于balena.io平台和balenaOS操作系统，同时也兼容其他支持相应架构的Docker环境。作为balenalib基础镜像的一部分，其核心价值在于提供物联网场景下的简化开发体验和设备兼容性。

核心功能与特性

1. 简化的包管理工具

提供install_packages脚本，抽象底层包管理器差异，具备以下特点：

• 自动选择最小依赖安装（忽略可选依赖）
• 安装后自动清理包管理器元数据
• 安装失败时支持自动重试机制

2. 动态设备支持

默认入口点为ENTRYPOINT ["/usr/bin/entry.sh"]，通过环境变量控制设备检测：

• 设置ENV UDEV=1时，自动启动udevd守护进程
• 支持动态插拔设备，容器内/dev目录将自动生成设备节点

更多特性详情参见***特性文档

镜像变体

balenalib镜像提供两种主要变体，满足不同开发阶段需求：

:<version> 或 :<version>-run

• 默认镜像变体，专注于运行时环境
• 精简设计，仅包含应用运行必需的核心组件
• 适合生产环境部署，最小化镜像体积

:<version>-build

• 包含完整构建工具链的开发镜像
• 预装源码编译所需的各类工具
• 减少手动安装依赖步骤，降低整体镜像体积

了解更多变体差异：***镜像变体文档

OpenJDK简介

OpenJDK（Open Java Development Kit）是Java Platform, Standard Edition (Java SE)的免费开源实现，自Java SE 7起成为***参考实现。它提供了Java开发和运行所需的完整工具链，包括编译器、运行时环境和类库。

参考：***OpenJDK条目
注：Java是Oracle及其关联公司的注册商标。

!OpenJDK Logo

使用场景与适用范围

• 物联网设备上的Java应用开发与部署
• 基于balenaOS的嵌入式系统开发
• 需要动态设备访问的Java应用（如传感器数据采集）
• 跨平台物联网解决方案的容器化部署

使用方法

基础使用示例（Dockerfile）

以下示例展示如何构建并运行Java应用：

FROM balenalib/imx8mm-var-som-debian-openjdk:latest
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
RUN javac Main.java  # 编译Java源代码
CMD ["java", "Main"]  # 运行应用

构建并运行命令：

# 构建镜像
docker build -t my-java-iot-app .

# 运行容器
docker run -it --rm --name my-running-app my-java-iot-app

仅编译应用（不运行）

如需在容器内编译但在外部运行，可使用以下命令：

docker run --rm \
  -v "$PWD":/usr/src/myapp \  # 挂载当前目录到容器
  -w /usr/src/myapp \          # 设置工作目录
  balenalib/imx8mm-var-som-debian-openjdk:latest \
  javac Main.java              # 执行编译命令

此命令会在当前目录生成Main.class编译结果，无需在宿主机安装Java环境。

用户反馈与支持

问题反馈

如遇使用问题或有疑问，请通过GitHub Issues提交。

贡献指南

欢迎提交功能改进、bug修复或文档更新。重大变更建议先通过GitHub Issues讨论，以确保与项目方向一致。

***文档

• balenalib基础镜像完整文档
• 新特性介绍

相关链接：
balena.io平台 | balenaOS操作系统