LightMusic 项目安装和配置指南

LightMusic 项目安装和配置指南

1. 项目基础介绍

LightMusic 是一个基于 Swing 和 JavaFX 的桌面端音乐播放器。该项目旨在为用户提供一个简单易用的音乐播放和管理工具，支持本地音乐管理、在线音乐收听、歌单同步等功能。

主要编程语言

• Java 8

2. 项目使用的关键技术和框架

• Swing: 用于构建桌面应用程序的用户界面。
• JavaFX: 用于增强用户界面的视觉效果和交互体验。
• Maven: 用于项目管理和依赖管理。

3. 项目安装和配置的准备工作

在开始安装和配置之前，请确保您的开发环境满足以下要求：

• JDK 8: 必须是最稳定的8版本，且自带了JavaFX开发工具包，无需额外下载。
• Maven: 用于构建和管理项目依赖。
• Git: 用于克隆项目代码。

安装步骤

3.1 克隆项目代码

首先，使用 Git 克隆 LightMusic 项目的代码库到本地：

git clone https://github.com/AffectionParadise/LightMusic.git

3.2 配置 Maven

进入项目目录并使用 Maven 进行初始化：

cd LightMusic
mvn clean install

3.3 运行项目

在项目目录下，找到 src/main/java/net/doge/App.java 文件，并运行该类：

mvn exec:java -Dexec.mainClass="net.doge.App"

3.4 打包项目

如果您需要将项目打包为可执行的 JAR 文件，可以按照以下步骤操作：

1. 主程序打包：

   • 在 LightMusic 项目结构中创建工件。
   • 构建该工件，生成一个名为 LightMusic.jar 的可执行 JAR 文件。

2. 更新程序打包：

   • 在 LightMusic-Updater 项目结构中创建工件。
   • 构建该工件，生成一个名为 LightMusic-Updater.jar 的可执行 JAR 文件。

3.5 编译为可执行程序

如果您希望将 JAR 文件编译为可执行程序（例如 Windows 下的 EXE 文件），可以使用第三方工具如 exe4j 进行编译。

编译完成后，确保以下文件位置关系正确：

├─jre：运行所需的 JVM 虚拟机环境
├─plugin：包含 ffmpeg 插件
├─resource：程序运行所需的资源文件
├─LightMusic.exe：主程序可执行程序
└─Updater.exe：更新程序可执行程序

4. 注意事项

• 确保所有依赖项都已正确安装和配置。
• 如果在安装和配置过程中遇到问题，请查阅项目的 GitHub 页面或提交 Issue 进行反馈。

通过以上步骤，您应该能够成功安装和配置 LightMusic 项目，并开始使用这个功能丰富的音乐播放器。