File Manager

注意:要显示特定设备上存在的功能,请从下面的 SmartDocs 栏中选择一个或多个过滤器。

StageNow - 2.10

概述

File Manager (FileMgr) 允许应用程序管理设备上的文件。例如,FileMgr 允许应用程序从服务器下载文件到设备,将文件或文件夹从设备的一个区域复制到另一个区域,以及删除设备上的文件。File Manager 还可以提取 XML 文档中嵌入的文件并从互联网下载,可能需要进行基本的身份验证,也可能不需要。

主要功能

  • 将文件从本地或远程位置复制到设备
  • 将文件从 XML 对象中嵌入的数据复制到设备
  • 将文件或文件夹从设备上的一个位置复制或移动到另一个位置
  • 从设备中删除文件
  • 将包含多个文件的文件夹或存档文件复制到设备
  • 使用 HTTP、HTTPS、FTP 或 FTPS (FTP over TLS/SSL) 从服务器下载文件
  • 支持在 URI 中嵌入时对 HTTP 服务器进行基本身份验证
  • 使用 HTTP 或 HTTPs 下载和处理使用 StageNow 生成的“.archive”文件
  • 在 Wi-Fi 或移动网络断开时重试和/或恢复操作
  • 等待连接可用后再启动下载

文件操作

用于指定要对文件执行的操作。

参数名称:FileAction

选项 名称 说明需要
1 传输/复制文件 将指定的文件复制到设备。

MX:4.3+

4 删除文件 从设备中擦除指定的文件。

MX:4.3+

9 下载和展开存档文件 将存档文件复制到设备并提取其内容。

MX:5.0+

目标访问方法

用于指定文件是存在于设备文件系统中还是嵌入在 XML 文件中。

在以下条件下显示:文件操作为“传输/复制”

参数名称:TargetAccessMethod

选项 名称 说明需要
2 文件在设备文件系统中 指定文件是设备文件系统中。

MX:4.3+

目标路径和文件名

用于指定在设备上要将文件操作的对象复制到的目标路径和文件名称。

参数值输入规则

  • 1 到 255 个字符的字符串,其中包含目标路径和文件名

在以下条件下显示:文件操作为“传输/复制”

参数名称:TargetPathAndFileName

需要:

  • MX:4.3+

目标 URI

用于指定要从远程服务器复制到设备的文件的位置 (URI)。

参数值输入规则

  • 包含源文件 URI 的字符串

在以下条件下显示:文件操作为“传输/复制”

参数名称:TargetURI

需要:

  • MX:4.3+

源访问

用于指定要复制或传输的源文件的位置到。

参数名称:SourceAccessMethod

选项 名称 说明需要
1 远程服务器上的文件 指示源文件在远程服务器上。

MX:4.3+

2 设备文件系统上的文件 指示源文件在设备上。

MX:4.3+

3 在 XML 中嵌入的文件 指示源文件嵌入在 XML 中。

MX:4.3+

源 URI

用于指定服务器上的文件位置 URI支持 HTTP、HTTPS、FTP 和 FTPS(通过 TLS 或 SSL 的 FTP)协议和嵌入式 URL 凭据的基本身份验证。请参阅示例部分了解语法。

参数值输入规则

  • 包含源文件 URI 的字符串
  • 凭据必须嵌入在 URI 中
  • 使用“protocol=SSL”覆盖默认值 (TLS)
  • 使用“implicit=true”覆盖默认值 (false)

在以下条件下显示:文件操作为“传输/复制”,源为远程服务器

参数名称:SourceURI

需要:

  • MX:4.3+

源路径和文件

用于指定设备上源文件位置的路径和文件名。

参数值输入规则

  • 包含源文件路径和文件名的字符串

在以下条件下显示:文件操作为“传输/复制”,源在设备上

参数名称:SourcePathAndFileName

需要:

  • MX:4.3+

嵌入文件类型

用于指定要嵌入的文件的类型。

在以下条件下显示:文件操作为“传输/复制”,源为“嵌入”

参数名称:SourceType

选项 名称 说明需要
1 一般数据文件(任何扩展名) 表示具有任意扩展名类型的源文件。

MX:4.3+

2 Android 应用程序包(.APK 文件) 表示具有扩展名 .APK 的源文件

MX:4.3+

3 Android OS 更新(.ZIP 文件) 表示具有 .ZIP 扩展名的源文件。

MX:4.3+

XML 嵌入源

用于指定要在 XML 中嵌入的源文件数据。

在以下条件下显示:文件操作为“传输/复制”和,源类型为“XML 中嵌入的文件”,源类型是“一般数据文件”

参数名称:SourceDataAny

需要:

  • MX:4.3+

APK 嵌入源

用于指定要在 XML 中嵌入的 APK 源文件数据。

在以下条件下显示:文件操作为“传输/复制”,源类型为“XML 中嵌入的文件”,嵌入类型为“Android 应用程序”远程服务器

参数名称:SourceDataApk

需要:

  • MX:4.3+

OS 更新嵌入源

提供要在 XML 中嵌入的源 ZIP 文件数据

在以下条件下显示:文件操作为“传输/复制”,源类型为“XML 中嵌入的文件”,嵌入类型为“Android OS 更新”远程服务器

参数名称:SourceDataZip

需要:

  • MX:4.3+

存档目标路径和文件夹名称

用于指定下载的存档文件应该解压缩到的路径和文件夹名称。

参数值输入规则

  • 1 到 255 个字符串的字符串,包含目标文件夹的路径和文件名

在以下条件下显示:文件操作为“下载并展开存档”

参数名称:ArchiveTargetPathAndFolderName

需要:

  • MX:5.0+

存档源 URI

用于指定源存档/ZIP 文件的 URI 。

参数值输入规则

  • 1 到 255 个字符的字符串,包含源存档/ZIP 文件的 URI

在以下条件下显示:文件操作为“下载并展开存档”

参数名称:ArchiveSourceURI

需要:

  • MX:5.0+

示例

从 HTTP/HTTPs 下载

<wap-provisioningdoc><characteristic type="FileMgr" version="5.0" ><parm name="FileAction" value="1"/><characteristic type="file-details"><parm name="TargetAccessMethod" value="2"/><parm name="SourceAccessMethod" value="1"/><parm name="SourceURI" value=" http://mycompany.com/file/emmtk.war"/><parm name="TargetPathAndFileName" value="/internal/tmpp/10m_testfile.bin"/></characteristic></characteristic></wap-provisioningdoc>

下载并取消存档

<wap-provisioningdoc><characteristic type="FileMgr" version="5.0" ><parm name="FileAction" value="9"/><characteristic type="file-details"><parm name="ArchiveTargetPathAndFolderName" value="/sdcard/Android/extract3"/><parm name="ArchiveSourceURI" value="https://secure.mycompany.com/httpsdownload/ArchiveFileTemp.archive"/></characteristic></characteristic></wap-provisioningdoc>

执行基本身份验证

<wap-provisioningdoc><characteristic type="FileMgr" version="5.0" ><parm name="FileAction" value="1"/><characteristic type="file-details"><parm name="TargetAccessMethod" value="2"/><parm name="SourceAccessMethod" value="1"/><parm name="SourceURI" value="http://userName@company.com:password@192.168.0.100/secure/10m_testfile.bin"/><parm name="TargetPathAndFileName" value="/internal/tmpp/10m_testfile.bin"/></characteristic></characteristic></wap-provisioningdoc>

使用显式连接从 FTPS 下载

<wap-provisioningdoc><characteristic version="0.6" type="FileMgr"><parm name="FileAction" value="1" /><characteristic type="file-details"><parm name="TargetAccessMethod" value="2" /><parm name="TargetPathAndFileName" value="/storage/sdcard0/MSC_FileMgr_FTPS_TC01_1.apk"/><parm name="SourceAccessMethod" value="1" /><parm name="SourceURI" value="ftps://userName@company.com:password@192.168.0.100/secure/10m_testfile.bin" /></characteristic></characteristic></wap-provisioningdoc>

使用隐式连接从 FTPS 下载

<wap-provisioningdoc><characteristic version="0.6" type="FileMgr"><parm name="FileAction" value="1" /><characteristic type="file-details"><parm name="TargetAccessMethod" value="2" /><parm name="TargetPathAndFileName" value="/storage/sdcard0/MSC_FileMgr_FTPS_TC01_1.apk"/><parm name="SourceAccessMethod" value="1" /><parm name="SourceURI" value="ftps://userName@company.com:password@192.168.0.100/secure/10m_testfile.bin?implicit=true" /></characteristic></characteristic></wap-provisioningdoc>

使用显式连接通过 Open SSL 服务器从 FTPS 下载

<wap-provisioningdoc><characteristic version="0.6" type="FileMgr"><parm name="FileAction" value="1" /><characteristic type="file-details"><parm name="TargetAccessMethod" value="2" /><parm name="TargetPathAndFileName" value="$DEVICEINTERNALLOC/MSC_FileMgr_FTPS_TC04_1.apk"/><parm name="SourceAccessMethod" value="1" /><parm name="SourceURI" value="ftps://userName@company.com:password@192.168.0.100/secure/10m_testfile.bin?ftpClient.keyStore.file=/enterprise/usr/stagenow/vsftpd.p12&amp;ftpClient.keyStore.password=password&amp;ftpClient.keyStore.type=PKCS12" /></characteristic></characteristic></wap-provisioningdoc>

使用隐式连接通过 Open SSL 服务器从 FTPS 下载

<wap-provisioningdoc><characteristic version="0.6" type="FileMgr"><parm name="FileAction" value="1" /><characteristic type="file-details"><parm name="TargetAccessMethod" value="2" /><parm name="TargetPathAndFileName" value="/storage/sdcard0/MSC_FileMgr_FTPS_TC02_1.apk"/><parm name="SourceAccessMethod" value="1" /><parm name="SourceURI" value="ftps://userName@company.com:password@192.168.0.100/secure/10m_testfile.bin?ftpClient.keyStore.file=/enterprise/usr/stagenow/vsftpd.p12&amp;ftpClient.keyStore.password=password&amp;ftpClient.keyStore.type=PKCS12&amp;implicit=true&amp;protocol=SSL" /></characteristic></characteristic></wap-provisioningdoc>