先决条件（本篇为官方文档的翻译）

Java 运行时 (JRE/JDK)

如果您使用的是 Raspbian 的最新版本，则预安装了 Oracle Java 运行时环境。没什么可做的。
如果您使用的是尚未包含 Java 运行时环境的较旧 Raspbian 版本，请参阅以下文章以获取有关安装 Oracle JDK 的完整安装说明。
http://www.savagehomeautomation.com/pi-jdk
注意：从 v1.3 开始，Pi4J 需要Java 8 JRE/JDK。必须在您的系统上安装和配置 Java 8 运行时环境。\

WiringPi 原生库

Pi4J 依赖于最初由 Gordon Henderson 创建的 WiringPi 原生库。有关 WiringPi 的更多信息，请参阅以下页面。
http://wiringpi.com/
Pi4J 本机库动态链接到 WiringPi，因此您必须在目标 Raspberry Pi 系统上安装 WiringPi。
注意：原始 WiringPi 库已 弃用，不再维护。
要支持 RaspberryPi 4B/400 和更新的系统，您必须安装最新的 *非官方 * WiringPi 版本，该版本在此处维护：https : //github.com/WiringPi/WiringPi。
如果您的 RaspberryPi 上安装了 Pi4J，您可以使用以下脚本命令下载、构建和安装WiringPi的最新非官方版本。
sudo pi4j --wiringpi

或者，您可以使用以下 shell 命令下载、构建和安装WiringPi的最新非官方版本。
sudo apt-get remove wiringpi -y
sudo apt-get --yes install git-core gcc make
cd ~
git clone git://github.com/WiringPi/WiringPi --branch master --single-branch wiringpi
cd ~/wiringpi
sudo ./build

安装

简单/首选

（注意：此安装方法需要您的树莓派连接到互联网。）
在 RaspberryPi 上安装 Pi4J 的最简单方法是直接在 RaspberryPi 上执行以下命令。
curl -sSL https://pi4j.com/install | sudo bash

此方法将下载并启动执行以下步骤的安装脚本：
将 Pi4J APT 存储库添加到本地 APT 存储库
下载并安装 Pi4J GPG 公钥以进行签名验证
在 Pi4J APT 存储库上调用“apt-get update”命令来更新本地包数据库
调用“apt-get install pi4j”命令来执行下载和安装

离线/手动

如果您更喜欢/需要在没有 Internet 连接的 RaspberryPi 设备上安装 Pi4J，以下说明提供了在不需要 Internet 连接的情况下安装 Pi4J 所需的步骤。
首先，将最新的 Pi4J Debian/Raspian 安装程序包 (.deb) 文件的副本下载到您的本地计算机。您可以使用 Web 浏览器在以下 URL 下载 Pi4J Debian/Raspian 安装程序包 (.deb)：https 😕/pi4j.com/download/pi4j-1.3.deb
接下来，您需要将下载的安装程序包传输到您的 RaspberryPi。您可以使用任何您喜欢的方法来传输文件（USB、SCP、FTP 等）
（注意：如果您安装了以前版本的 Pi4J，则需要先卸载它。）
一旦安装程序包在您的 RaspberryPi 上可用，请在 Pi 上使用以下命令执行安装：
sudo dpkg -i pi4j-1.3.deb

升级

简单/首选

如果您最初使用“简单”方法安装 Pi4J ，那么无论何时您使用“sudo apt-get update”和“sudo update-get upgrade”执行系统更新，都可以使用 Pi4J 升级。
如果您只想强制升级 Pi4J 软件包，可以通过执行以下命令来实现：
sudo apt-get install pi4j
#或者
pi4j --update

离线/手动

如果您最初使用“离线”方法安装 Pi4J ，那么您将需要手动卸载 Pi4J 软件包并使用本页此处描述的“离线”卸载和安装方法下载、传输和安装新版本软件包。

卸载

简单/首选

如果您最初使用“简单”方法安装 Pi4J ，那么您只需在 RaspberryPi 上执行以下命令即可卸载 Pi4J。
sudo apt-get remove pi4j
#或者
pi4j --uninstall

完全/完全移除

如果您最初使用“简单”方法安装 Pi4J，并且想要删除 Pi4J 的所有痕迹，包括 APT 存储库列表中的 Pi4J 存储库和 Pi4J GPG 签名，那么只需在您的 RaspberryPi 上执行以下命令。
curl -sSL https://pi4j.com/uninstall | sudo bash

离线/手动

如果您最初使用“离线”方法安装 Pi4J ，则需要通过在 Raspberry Pi 上执行以下命令手动卸载 Pi4J 包：

sudo dpkg -r pi4j

安装位置/示例文件

这会将 Pi4J 库和示例源文件安装到：

/opt/pi4j/lib
/opt/pi4j/examples

尝试使用 Pi4J 库编译 Java 程序时，请确保在类路径中包含 Pi4J lib 文件夹：

javac -classpath .:classes:/opt/pi4j/lib/'*' ...

尝试使用 Pi4J 库启动 Java 程序时，请确保在类路径中包含 Pi4J lib 文件夹：

sudo java -classpath .:classes:/opt/pi4j/lib/'*' ...

如果您想探索示例，可以使用以下命令编译所有示例：

/opt/pi4j/examples/build