Spine故障排除

运行Spine遇到困难? 使用Spine时是否无法启动或崩溃?你来对地方了!

虽然我们努力让Spine在所有计算机上都能完美运行,但有时会出问题,或者Spine运行在我们以前未见过的配置上。在此页面上,你可以找到许多可以检查的事项以使Spine正常运行。

spine.log

当Spine运行时,它做的第一件事是在此位置创建一个日志文件:

Windows

%UserProfile%\Spine\spine.logC:\Users\<user name>\Spine\spine.log

macOS

~/Library/Application Support/Spine/spine.log

Linux

~/.spine/spine.log

如果发生任何错误,它们将出现在此文件中。有时错误消息与看似难以理解的信息混杂在一起,因此请仔细阅读。如果你无法理解这些错误,可以将其发布到论坛发送给我们。请发布或通过电子邮件发送整个日志,而不是部分日志(论坛会自动从日志中删除你的姓名和电子邮件)。此外,告知你在发生错误时正在做什么也有很大帮助。我们喜欢修复Spine中的错误,如果你能帮助我们重现你发现的任何问题,我们将非常感谢。

Spine每次运行时都会删除spine.log文件并创建一个新的空文件。如果Spine崩溃,则应在再次运行Spine之前检查spine.log文件。

缺少spine.log

如果未创建spine.log文件,则意味着Spine在启动过程中很早就出现了问题。你需要从命令行运行Spine:

Windows

打开 Command Prompt 并输入: "C:\Program Files (x86)\Spine\Spine.com"

macOS

  • 打开 Terminal 并输入: /Applications/Spine/Spine.app/Contents/MacOS/Spine
  • 或者,在MacOS上,你可以运行控制台应用程序,选择所有消息,然后启动Spine并在控制台应用程序中查看输出。

Linux

运行: Spine.sh

当以这种方式运行Spine时,将在命令行窗口中输出Spine的日志记录,并且你可能会看到一些错误,这些错误提供了有关Spine无法启动的原因线索。

在MacOS上,其他软件可能会与Spine冲突。例如,屏幕镜像软件或Finder“增强工具”(如Default Folder X)可能会阻止Spine运行。此外,启动Spine时可能需要关闭Rescue Time。

防病毒和防恶意程序软件

某些防病毒或防恶意程序软件(如Bit Defender或360 Browser)可能会修改或删除Spine的文件。这可能会导致Spine完全无法运行,或在以后出现故障。你需要禁用此类软件或将Spine文件夹列入白名单。Spine的文件夹在:

Windows

  • C:\Program Files (x86)\Spine\ (或你安装Spine的文件夹)
  • %UserProfile%\Spine<user home folder>\Spine

macOS

  • /Applications/Spine/
  • ~/Library/Application Support/Spine/

Linux

  • 你解压并放置Spine的文件夹。
  • ~/.spine/

过时的启动程序

首先要检查的一件事是你是否正在运行最新的Spine启动程序。为此,请转到购买Spine时收到的Spine许可证页面,然后下载并重新安装Spine。如果找不到Spine许可证页面,可以使用许可证恢复页面

连网

安装Spine时,实际上是在安装Spine启动程序。当你运行Spine时,它需要下载你要运行的Spine版本。之后,可以在没有网络连接的情况下运行Spine。

证书过期

如果你在2020年2月15日之前下载了Spine,或者你的Spine启动程序版本低于3.8.82,则Spine无法访问服务器。由于旧Spine安装中的证书已过期,你需要下载并重新安装Spine。你可以在Spine许可证页面上找到下载链接,也可以使用许可证恢复页面

服务器

Spine的服务器分布在日本、欧洲和美国。如果你位于中国,或者你与服务器的连接速度很慢,则可能需要多次尝试,使用VPN,或稍后重试。

Spine会自动为你选择连接最佳服务器,如果失败,还会尝试所有其他服务器。Spine会每隔几天检查一次最佳连接,也可通过从命令行使用--ping运行Spine来强制检查。还可以使用--server jp--server eu--server us强制它首选特定的服务器。

防火墙

如果你的路由器或其他网络硬件上有防火墙,或者软件防火墙阻止Spine访问服务器,则需要禁用防火墙或添加规则以允许Spine的通信。Spine使用端口44380连接到*.esotericsoftware.com

Hosts文件

如果hosts文件包含重定向esotericsoftware.com网络通信的条目,则Spine将无法运行。你将在spine.log文件中看到有关它的错误消息,并且需要编辑hosts文件以删除该条目:

Windows

C:\Windows\System32\drivers\etc\hosts

macOS和Linux

/etc/hosts

代理

如果你需要连网才能使用代理服务器,则需要使用一个特殊命令启动Spine来指定代理服务器。

过时的音频和视频驱动程序

Spine使用硬件加速的音频和视频(OpenAL和OpenGL)。音频或视频硬件驱动程序中的任何错误都可能导致Spine崩溃或完全无法运行。通过访问音频和视频硬件的制造商网站,确保你拥有最新的驱动程序,否则下载并安装提供的最新驱动程序。

禁用音频

如果你不需要Spine的音频功能,则可以通过使用--disable-audio命令行参数启动Spine来禁用Spine对音频硬件的使用。我们收到过一些游戏笔记本电脑音频驱动程序损坏的报告。

用户文件

Spine将设置和其他文件存储在你的用户文件夹中:

Windows

%UserProfile%\Spine<user home folder>\Spine

macOS

~/Library/Application Support/Spine/

Linux

~/.spine/

你可以安全地删除整个文件夹以及其中的所有内容。但是,你可能需要先保存一些文件:

  • backup子文件夹是你每次保存时Spine存储项目副本的位置。
  • .json文件是Spine存储设置的位置。删除它们会将Spine重置为默认设置。
  • hotkeys.txt文件是Spine存储各种操作热键的位置。如果你自定义了此文件,则可能需要保留该文件的副本。
  • updates子文件夹是Spine存储下载的更新的位置。删除它们将导致Spine再次下载更新。

过时的Spine版本

你可以在Spine的设置中选择运行哪个版本的Spine。如果Spine崩溃,你可能想尝试最新的更新。请注意,如果使用较新版本保存项目,则较旧版本将无法打开。

要运行最新版本,请在Spine的设置中选择最新。如果你无法进入设置对话框,可以删除这里的version.txt文件:

Windows

%UserProfile%\Spine\version.txt<user home folder>\Spine\version.txt

macOS

~/Library/Application Support/Spine/version.txt

Linux

~/.spine/version.txt

如果该文件不存在,则Spine将使用最新版本。如果该文件存在,Spine将使用文件中指定的版本。

你还可以通过命令行指定版本。首先从changelog中选择一个版本,例如3.7.94,然后按如下方式运行Spine:

Windows

打开Command Prompt并输入: "C:\Program Files (x86)\Spine\Spine.com" --update 3.7.94

macOS

打开Terminal并输入: /Applications/Spine/Spine.app/Contents/MacOS/Spine --update 3.7.94

Linux

运行: Spine.sh --update 3.7.94

如果你在使用最新版本时遇到问题,可以尝试返回到较旧版本(如果尚未使用较新版本保存项目,或者从备份中获得较旧版本的项目)。我们修复错误的速度非常快,通常在几天内(特别是当用户向我们展示如何重现问题时!),但是如果你在使用最新版本时遇到问题,你可能希望使用较旧的版本,这样可以提高工作效率,而不是等待修复。

仍然有问题吗?

如果你已经阅读了上面的信息,但是在运行Spine时仍然有问题,请在论坛上发布问题或与我们联系