Android文件服务器

Android文件服务器（Android File Server，简称AFS） 是 虚幻引擎（UE） 的插件，用于在你打包 开发、调试 或 测试 项目（也可以是 发布项目 ，参阅下文）版本时将文件服务器嵌入你的Android应用程序。只要文件服务器在运行，你就可以使用 UnrealAndroidFileTool 来管理、推送和查看文件。在包含AFS的版本中，虚幻引擎会将其用于部署快速启动。AFS和UnrealAndroidFileTool一起构成了使用 Android调试桥（Android Debug Bridge，简称ADB） 之外的替代选择，可提供针对虚幻引擎的工作流程量身定制的许多相同功能。

AFS并不使用设备的SD卡外部存储来处理快速启动，而是使用项目包沙盒存储。这样一来，你就可以使用文件操作，而不需要存储权限或限定了范围的访问权限，因为在你开发项目和部署版本的过程中，不断重新启用这些权限会很麻烦。AFS还可以通过WiFi连接和/或USB连接运作，以更快进行部署。

配置和设置

本分段说明了如何配置AFS的打包和连接。你可以在 项目设置（Project Settings） > 插件（Plugins） > AndroidFileServer 中找到这些设置。本分段列出了可供配置的每个参数。

打包设置

打包（Packaging） 分段包含的设置用于配置哪种类型的版本将包含AFS，以及文件服务器将拥有哪些功能。AFS会默认启用，并且非发布版本将自动在你的项目中嵌入文件服务器，除非将其禁用。AFS在默认情况下未包含在发布版本中，但有设置可将其启用。

在发布版本中使用AFS

发布版本通常不包含AFS，但你可以启用 包含在发布中（Include in Shipping） 和 在发布中允许外部启动（Allow External Start in Shipping） 来添加AFS。如果你只启用包含在发布中（Include in Shipping），你仍可以使用AFS，但它不会用于快速启动，并且你需要从应用程序内部手动启动和停止它。

启动和停止AFS

使用非发布版本时，或为发布版本启用外部启动时，将注册一个接收器来允许远程启动和停止文件服务器。你可以使用UnrealAndroidFileTool连接到设备的文件服务器并管理文件。否则，在启用AFS的情况下，你需要从你的虚幻引擎应用程序内部手动启动文件服务器。请参阅使用蓝图手动启动和停止AFS，了解更多信息。

使用安全令牌

如果你填写了 安全令牌（Security Token） 字段，文件服务器将要求来自UnrealAndroidFileTool的所有传入连接请求提供匹配的安全令牌。请参阅UnrealAndroidFileTool参考，了解更多信息。

安全令牌仅提供基本安全性，不会以任何方式加密。你可以使用Android文件服务器蓝图库，在发布版本中自行提供更强大的安全性。使用安全令牌时，务必不要将令牌提供给组织外部的人。

编译AFSProject并手动安装AFS

如果启用了 编译AFSProject（Compile AFSProject） ，将打包一个包含文件服务器的独立APK，它会匹配你的项目的配置和密钥签名。 你可以将此APK安装到设备，以使用 adb install -r 选项管理新文件或现有文件。 之后，你可以使用相同的选项重新安装你的实际APK，而不会影响内部或外部数据文件。如果你需要在没有内置服务器的发布版本上管理文件，这尤其有用。

无论是否启用编译AFSProject（Compile AFSProject），发布版本都会编译AFSProject。

部署设置（日志记录和压缩）

部署（Deployment） 分段中的设置用于控制文件服务器在你的日志中报告哪些信息。

启用日志输出设置时，虚幻引擎会在快速启动期间将有关AFS的安装过程的信息记录到 控制台（Console） 窗口中。

同时启用USB和网络时的日志记录

如果同时启用USB和网络，AFS日志将显示一个前缀，表示文件是通过哪种类型的连接发送的。

例如，以下行表示了地图文件是通过USB发送的。

	1> TestGameEntry.umap

Copy full snippet

1> TestGameEntry.umap

如果你同时使用USB和WiFi，当一个连接繁忙时，另一个连接将接管。

	1> TestGameEntry.umap
	2> TestTexture.uasset
	2> TestMaterial.uasset
	1> TestPawn.uasset

Copy full snippet

1> TestGameEntry.umap 2> TestTexture.uasset 2> TestMaterial.uasset 1> TestPawn.uasset

连接设置

连接（Connection） 分段包含一些选项，用于配置AFS将使用哪种类型的连接来将你的计算机连接到设备。

连接类型

连接类型（Connection Type） 下拉菜单可供选择要使用哪种类型的连接来推送文件。

除非你覆盖端口，否则AFS的默认端口是57099。

使用手动IP地址

如果你启用 使用手动IP地址（Use Manual IP Address） 设置，并提供你的Android设备的IP地址，当你部署版本时，AFS将连接到该设备，而不是一般设备管理器工作流程中的默认设备。该设备仍必须连接到你的计算机所在的相同WiFi网络。

使用蓝图手动启动和停止AFS

你可以使用Android文件服务器蓝图库从你的UE应用程序内部手动启动、停止文件服务器并检查其状态。

AFS可以使用专为你的项目生成的唯一令牌提供基本安全性，相较于使用默认广播接收器，这些蓝图节点则适合创建更安全的方法来启动和停止AFS。

UnrealAndroidFileTool

UnrealAndroidFileTool是一种命令行工具，可以连接到你的设备上部署的文件服务器来手动管理文件。该工具位于引擎的安装目录中的 Engine/Binaries/DotNET/Android/UnrealAndroidFileTool 下。该目录包含Linux、MacOS和Windows版本的可执行文件的文件夹。

如果你需要所有三个操作系统的UnrealAndroidFileTool可执行文件版本，请打开 项目设置（Project Settings） > 平台（Platforms） > Android，然后为所有平台启用 生成安装文件（Generate Install Files）。如果未启用该设置，虚幻引擎将仅提供与打包的目标目录中的编辑器主机类型匹配的可执行文件。

当你通过命令行运行该可执行文件时，它将显示包含其所有可用函数的菜单。你可以在命令行中附加其中任一命令来运行可执行文件。

命令参考

UnrealAndroidFileTool的命令包含一组 参数，向该工具指明要与什么建立连接，其后将跟随要发送到文件服务器的 命令。例如，以下内容将在带有特定序列号的设备上运行shell命令，并查看特定项目的文件：

	UnrealAndroidFileTool.exe -s AB187923123CD123 -p com.OrganizationName.ProjectName shell

Copy full snippet

UnrealAndroidFileTool.exe -s AB187923123CD123 -p com.OrganizationName.ProjectName shell

设置路径格式

AFS中的路径使用命令行路径的一般规范，但也支持导航文件层级的几个快捷键

下面是使用 ^[key] 的一些常见快捷键。你不一定要使用这些快捷键，但快捷键比较方便。

参数

以下参数可以放在文件服务器命令之前，为具体目标设备和项目配置你的连接。

设备管理命令

下表提供了命令参考，你可以使用这些命令获取可用设备和已识别包的信息，或用于停止远程服务器。

与文件服务器交互的所有命令，例如 push 、pull 或 shell ，都会隐式请求该服务器启动，因此没有用于启动服务器的命令。

交互模式命令

你可以使用以下命令进入和退出 交互模式。交互模式的运作机制类似于ADB，打开与设备的连接，让你能够发送多个命令，而不必为每个命令运行UnrealAndroidFileTool.exe。UnrealAndroidFileTool将保持交互模式，直至你退出为止。

查询和导航命令

以下命令可获取有关你的设备上的目录和文件的信息，或在交互模式期间为你的基本目录提供导航。

文件管理

以下命令将与你设备上的文件交互或修改这些文件。

命令行文件命令

以下命令将与你远程设备上的项目的 UECommandLine.txt 文件交互或修改此文件。