Jellium Desktop命令行脚本基础教程:脚本基础
2026/7/27 20:43:34 网站建设 项目流程

Jellium Desktop命令行脚本基础教程:脚本基础

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

Jellium Desktop是一款非官方的Jellyfin桌面客户端,通过命令行脚本可以轻松完成项目的构建、测试和维护工作。本文将带你快速掌握Jellium Desktop项目中常用命令行脚本的基础用法,让你轻松上手项目管理。

项目脚本概览

Jellium Desktop项目为不同操作系统提供了丰富的命令行脚本,主要集中在dev目录下,包括Linux、macOS和Windows三个平台的专用脚本:

  • Linux平台dev/linux/目录下包含AppImage打包脚本appimage/run.sh、Flatpak构建脚本等
  • macOS平台dev/macos/目录下提供setup.sh依赖安装脚本和build_dmg.sh打包脚本
  • Windows平台dev/windows/目录下有build_mpv_source.ps1等PowerShell脚本

此外,项目根目录下的justfile提供了统一的任务管理接口,通过简单的命令即可执行复杂操作。

基础脚本使用指南

Linux平台核心脚本

dev/linux/appimage/run.sh是Linux平台最常用的脚本之一,用于运行最新构建的AppImage包:

#!/bin/sh # Run the most recently built .AppImage via the stable symlink in build/appimage/ set -eu SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../../.." && pwd)" exec "${PROJECT_ROOT}/build/appimage/JelliumDesktop.AppImage" "$@"

使用方法非常简单,在终端中执行:

# 赋予执行权限 chmod +x dev/linux/appimage/run.sh # 运行脚本 ./dev/linux/appimage/run.sh

macOS平台依赖安装

dev/macos/setup.sh脚本用于自动安装macOS平台的所有构建依赖:

#!/usr/bin/env sh # Jellium Desktop - macOS dependency installer # Run once to install all build dependencies set -eu echo "Checking Xcode Command Line Tools..." # 检查并安装Xcode命令行工具 # 检查并安装Homebrew # 安装必要的依赖包

执行此脚本将自动安装包括cmake、ninja、ffmpeg等在内的所有依赖:

# 赋予执行权限 chmod +x dev/macos/setup.sh # 运行安装脚本 ./dev/macos/setup.sh

Windows平台MPV构建

dev/windows/build_mpv_source.ps1是Windows平台的PowerShell脚本,用于从源代码构建MPV媒体播放器组件:

# Build mpv from submodule source using MSYS2 for dependencies # Produces the custom mpv fork (with gpu-next/Vulkan support) as a Windows DLL # Prerequisites: MSYS2 installed (https://www.msys2.org/) param( [string]$MsysPath = "C:\msys64", [ValidateSet("x64", "arm64")] [string]$Arch = "x64", [switch]$Force ) # 检查MSYS2安装 # 安装依赖包 # 配置并构建MPV # 生成导入库 # 收集运行时依赖

使用方法:

# 在PowerShell中执行 .\dev\windows\build_mpv_source.ps1 # 指定架构和强制重建 .\dev\windows\build_mpv_source.ps1 -Arch x64 -Force

使用Justfile管理项目

项目根目录下的justfile提供了统一的任务管理接口,通过简单的命令即可执行复杂操作。Just是一个命令行工具,类似于Makefile但语法更简洁。

常用Just命令

  • 清理构建产物

    just clean
  • 运行测试

    just test
  • 代码格式化

    just fmt
  • 代码检查

    just clippy
  • 列出所有可用命令

    just list

Justfile示例解析

justfile中定义了跨平台的任务,例如清理任务:

# Remove build artifacts [group('maintenance')] [macos] [linux] clean: rm -rf build dist cargo clean --manifest-path src/Cargo.toml # Windows平台的清理任务 [group('maintenance')] [windows] clean: if (Test-Path build) { Remove-Item -Recurse -Force build } if (Test-Path dist) { Remove-Item -Recurse -Force dist } cargo clean --manifest-path src/Cargo.toml

Just会根据当前操作系统自动选择对应的任务执行,无需手动指定平台。

开始使用Jellium Desktop命令行脚本

要开始使用Jellium Desktop的命令行脚本,首先需要克隆项目仓库:

git clone https://gitcode.com/GitHub_Trending/je/jellium-desktop cd jellium-desktop

然后根据你的操作系统,运行相应的设置脚本:

  • Linux:无需额外设置,可直接使用just命令
  • macOS
    ./dev/macos/setup.sh
  • Windows
    .\dev\windows\setup.ps1

完成设置后,即可使用just命令管理项目:

# 构建项目 just build # 运行应用 just run # 打包应用 just package

通过这些简单的命令行脚本,你可以轻松管理Jellium Desktop项目的构建、测试和打包过程,大大提高开发效率。无论是新手还是有经验的开发者,都能快速上手这些实用工具。

【免费下载链接】jellium-desktopAn unofficial desktop client for Jellyfin项目地址: https://gitcode.com/GitHub_Trending/je/jellium-desktop

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询