Godot Export 项目常见问题解决方案

Godot Export 项目常见问题解决方案

1. 项目基础介绍和主要编程语言

Godot Export 是一个开源项目，旨在为 Godot 游戏引擎提供自动化的游戏导出功能。通过使用 GitHub Actions，这个项目可以帮助开发者自动导出他们的 Godot 游戏到不同的平台。主要编程语言为 JavaScript 和 TypeScript，因为它是基于 GitHub Actions 的，而 Actions 的配置通常是使用这些语言来编写的。

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题一：如何配置导出预设

问题描述： 新手在使用该项目时可能不知道如何在 Godot 编辑器中配置导出预设。

解决步骤：

1. 打开 Godot 编辑器。
2. 转到 "项目" 菜单，选择 "导出"。
3. 在弹出的窗口中创建一个新的导出配置。
4. 设置导出路径，并为每个平台选择正确的文件扩展名（例如，Windows 为 .exe，macOS 为 .app，Linux 为 .x86_64 等）。
5. 保存配置后，确保导出预设文件（export_presets.cfg）位于项目根目录。

问题二：如何设置 GitHub Actions 工作流

问题描述： 新手可能不清楚如何设置 GitHub Actions 工作流来自动导出游戏。

解决步骤：

1. 在你的 GitHub 仓库中创建一个名为 .github/workflows 的新文件夹（如果尚未存在）。

2. 在该文件夹中创建一个新的 YAML 文件，例如 godot-export.yml。

3. 在 YAML 文件中配置所需的工作流，包括触发条件、使用的 Godot 版本和导出模板等。以下是一个基本的工作流配置示例：

   name: Auto Export Godot Game
   
   on:
     push:
       branches:
         - main
   
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v2
         - name: Set up Godot
           uses: firebelley/godot-export@master
           with:
             godot_executable_download_url: 'https://godotengine.org/download'
             godot_export_templates_download_url: 'https://github.com/godotengine/godot export templates.git'
         - name: Export the game
           run: godot-export.sh
   

4. 保存并推送到 GitHub，工作流将在满足触发条件时自动运行。

问题三：如何处理导出失败

问题描述： 新手可能会遇到导出失败的情况，但不确定如何解决。

解决步骤：

1. 检查 GitHub Actions 工作流日志以找到失败的原因。
2. 确认 export_presets.cfg 文件中的导出配置是否正确无误。
3. 检查是否正确设置了 Godot 可执行文件和导出模板的下载链接。
4. 如果使用的是自定义脚本或插件，请确保它们在当前版本的 Godot 上运行正常。
5. 如果问题仍然存在，可以在项目的 GitHub Issues 页面中搜索类似问题或创建一个新的问题请求帮助。