HTTPS支持的安装函数

以下 API 支持 HTTP 以及 HTTPS。

• CriWare.CriFsWebInstaller
• CriWare.CriFsUtility.WebInstall

以下是一个显示了如何使用该函数的样本项目。

• [CriFs] 数据安装(HTTPS)
• [CriFs] 批量安装数据

注意

当在 iOS 上使用该函数时，操作环境必须为 iOS 7 或更新版本。

初始化

请在以上任何情况下使用 CriWare.CriFsWebInstaller.InitializeModule 函数进行初始化。
并且请在完成使用时调用 CriWare.CriFsWebInstaller.FinalizeModule 函数。

CriFsWebInstaller.ModuleConfig moduleConfig = CriFsWebInstaller.defaultModuleConfig;
moduleConfig.numInstallers = 3; // 从默认的2增加至3
moduleConfig.inactiveTimeoutSec = 60;

CriFsWebInstaller.InitializeModule(moduleConfig();

注意

CriWareInitalizer 模块的设置值不会被使用。
同时的安装请求的最大数量将独自于 CriFsWebInstaller.ModuleConfig.numInstallers 进行调整。

从 CriFsInstaller 的转变

如果你使用了 CriWare.CriFsInstaller 组，请将其替换至 CriWare.CriFsWebInstaller 组。
其基础的 API 规格基本相同，但请注意以下几点。

注意：

• 初始化 初始化进程是必需的。
• 当 CriFsInstaller 连接至服务器一次后，它将无限地在内部进行重试，并且不会超时。
  另一边， CriFsWebInstaller 将在初始化设置的时间后超时。
• 将 CriFsInstaller.GetStatus() 以及 CriFsInstaller.GetProgress() 替换为 CriFsWebInstaller.GetStatusInfo()。
• CriFsWebInstaller 无法在复制的时候设置 CriFsBinder。
• CriFsInstaller 将覆盖已经安装的文件。而 CriFsWebInstaller 并不会覆盖，而且会带来错误。
  必要时请事先在应用侧删除文件。(需要确认文件是否存在时请使用C#的System.IO.File.Exists方法。)
• CriFsInstaller 和 CriFsWebInstaller 的HTTP请求方式不同。

额外规格：

• 可使用 CriFsWebInstaller::GetStatusInfo 函数获取错误信息。
• CriWareIntializer 组件的 installBufferSize 更改了 CriFsInstaller 的进程，但是 CriFsWebInstaller 并不会依赖于此，并且能够获取比特单位的进程。

由 CriFsUtility.Install() 而来的转变

如使用了 CriWare.CriFsUtility.Install() 进行安装，请将其替换至 CriWare.CriFsUtility.WebInstall()。
其基础的 API 规格基本相同，但请注意以下几点。

注意

• 初始化 初始化进程是必需的
• 当 CriFsUtility.Install() 连接至服务器一次后，它将无限地在内部进行重试，并且不会超时。
  另一边， CriWare.CriFsUtility.WebInstall() 将在初始化设置的时间后超时。
• CriFsUtility.WebInstall() 无法在复制的时候设置 CriFsBinder。
• CriFsUtility.Install() 和 CriFsUtility.WebInstall() 的HTTP请求方式不同。

额外规格：

• CriWareIntializer 组件的 installBufferSize 更改了 CriFsUtility.Install() 的进程，但是 CriFsUtility.WebInstall() 并不会依赖于此，并且能够获取比特单位的进程。

注意：

• 为维持 CriFsUtility.Install() 函数的兼容性，CriFsUtility.WebInstall() 将在文件已经存在的时候自动删除文件。
• CriFsUtility.Install() 无法复制不同本地储存的文件。请使用 CriFsUtility.Install()。

关于内部错误重试

以下情况时将内部进行重试。

• 网络连接过早结束
• 互联网连接的中途失效

如果连接甚至无法在初始化设置的超时时间过去后再次开始，那么将会出现超时错误。
和传统的 CriFsInstaller 以及 CriFsUtility.Install() 相同，如果无法在安装的一开始连接至互联网，用户将在重试前立即收到错误信息。

和先前相同，如出现404,504等HTTP错误，重试将不会于内部进行。
由于 CriFsWebInstaller 组能够重新获取错误原因以及HTTP进度代码，请参照应用程序的附属细则处理错误。
CriFsUtility.WebInstall() 无法获取详细信息。如果你需要更详细的错误操作，请使用 CriFsWebInstaller 组。

注意

iOS版下，第一次连接时若没有网络连接，内部将会尝试重新连接
请注意SDK Ver.2.87 版本进行了以上更改。