FGO-py打包分发:PyPI发布与pip安装配置
项目概述
FGO-py是一个 Fate/Grand Order(命运-冠位指定)的助手工具,提供自动化游戏操作,适合对游戏开发和自动化脚本有兴趣的程序员。项目采用Python开发,支持多平台运行,包括Windows、Linux、Android等系统。本文将详细介绍如何将FGO-py打包为Python包并发布到PyPI,以及如何通过pip进行安装配置。
项目结构
FGO-py项目主要包含以下核心模块:
- 主程序模块:fgo.py
- 设备连接模块:fgoDevice.py
- 战斗逻辑模块:fgoFarming.py
- 图形界面模块:fgoGui.py
- 配置文件模块:fgoConfig.py
环境准备
依赖项安装
FGO-py项目依赖以下Python库,在打包前需确保这些依赖已正确安装:
airtest
PySide6
tqdm
Flask
pponnxcr
pulp
matplotlib
netifaces
上述依赖可通过项目根目录下的requirements.txt文件安装,执行以下命令:
pip install -r requirements.txt
打包工具安装
打包Python项目需要使用setuptools和wheel工具,安装命令如下:
pip install setuptools wheel twine
打包配置
创建setup.py文件
在项目根目录下创建setup.py文件,用于配置打包信息。以下是一个基本的setup.py配置示例:
from setuptools import setup, find_packages
with open("README.md", "r", encoding="utf-8") as fh:
long_description = fh.read()
setup(
name="fgo-py",
version="1.0.0",
author="Your Name",
author_email="your.email@example.com",
description="A Fate/Grand Order assistant tool",
long_description=long_description,
long_description_content_type="text/markdown",
url="https://link.gitcode.com/i/23c52f1702745985ff131ca0acca54bf",
packages=find_packages(),
classifiers=[
"Programming Language :: Python :: 3",
"License :: OSI Approved :: GNU Affero General Public License v3",
"Operating System :: OS Independent",
],
python_requires='>=3.11',
install_requires=[
"airtest",
"PySide6",
"tqdm",
"Flask",
"pponnxcr",
"pulp",
"matplotlib",
"netifaces",
],
entry_points={
'console_scripts': [
'fgo-py = fgoCli:main',
],
},
)
创建MANIFEST.in文件
为确保打包时包含所有必要的文件(如图像资源、配置文件等),需要创建MANIFEST.in文件,内容如下:
include *.py
include fgoImage/*
include fgoImage/class/*
include fgoImage/cn/*
include fgoImage/jp/*
include fgoImage/na/*
include doc/*
include requirements.txt
执行打包
在项目根目录下执行以下命令进行打包:
python setup.py sdist bdist_wheel
打包成功后,会在项目根目录下生成dist文件夹,其中包含.whl文件和.tar.gz文件,这些就是可以发布到PyPI的包文件。
发布到PyPI
注册PyPI账号
如果还没有PyPI账号,需要先在PyPI官网注册账号。
上传包文件
使用twine工具上传打包好的文件到PyPI,执行以下命令:
twine upload dist/*
根据提示输入PyPI账号和密码,上传成功后即可在PyPI上搜索到fgo-py包。
pip安装与配置
安装fgo-py
通过pip命令安装fgo-py:
pip install fgo-py
运行FGO-py
安装完成后,可以通过以下命令启动FGO-py的命令行界面:
fgo-py cli
或者启动图形界面:
fgo-py gui
配置设备连接
FGO-py支持多种设备连接方式,包括USB连接和网络连接。在命令行界面中,可以使用以下命令连接设备:
connect /bs5 # 连接BlueStacks 5模拟器
connect /gw # 通过网关IP连接设备
设备连接成功后,即可开始使用FGO-py的自动化功能。
常见问题解决
打包时缺少文件
如果打包时提示缺少文件,检查MANIFEST.in文件是否包含了所有必要的文件路径。
设备连接失败
设备连接失败时,可以尝试以下解决方法:
- 确保ADB工具已正确安装并添加到环境变量
- 检查设备是否开启USB调试模式
- 使用
adb devices命令确认设备已被识别
图形界面无法启动
如果图形界面无法启动,可能是PySide6库安装问题,尝试重新安装:
pip install --upgrade PySide6
总结
通过本文介绍的步骤,你可以将FGO-py项目打包为Python包并发布到PyPI,方便其他用户通过pip安装使用。FGO-py提供了灵活的设备连接方式和强大的自动化功能,可以帮助玩家更轻松地进行游戏。
如果你在使用过程中遇到问题,可以参考项目的官方文档README.md或提交issue寻求帮助。
相关资源
- 项目源码:FGO-py
- 版本记录:doc/versions.md
- 部署指南:deploy/
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考




