安装插件文件

将容器字段中的插件文件安装或更新到计算机上。

选项 

指定目标字段”可指定您要安装或更新的插件所在的容器字段。如果没有指定字段,FileMaker Pro 会安装活动表中当前容器字段中的插件。

兼容性 

产品 是否支持
FileMaker Pro
FileMaker Go
FileMaker WebDirect
FileMaker Server
FileMaker Cloud
FileMaker Data API
自定义 Web 发布

原始版本 

12.0

说明 

必须先将插件插入容器字段,才能安装或更新插件。请参阅插入文件安装插件

只能安装 FileMaker 插件文件。如果目标或活动容器字段中没有插件文件,在脚本运行时不执行任何操作。插件扩展名必须是 .fmx64 (Windows)、.fmplugin (macOS) 或 .fmx (Linux)。

无法安装 ZIP 格式的压缩插件文件或 TAR 格式的插件文件。

您可以使用 Get (安装的 FM 插件) 函数确定已安装插件的名称、版本和已启用状态。此函数可帮助您确定已安装的插件比解决方案文件所需的插件更新还是更旧。请参阅 Get (安装的 FM 插件)Get ( 安装的 FM 插件为 JSON )

必须在插件首选项中启用插件,FileMaker Pro 才能识别它们。如果“安装插件文件”脚本步骤安装了插件更新,但在插件首选项中禁用了该插件,则 FileMaker Pro 会安装更新,但不启用该插件。请参阅设置插件首选项

对于由 FileMaker Server 托管的文件,服务器管理员必须在“管理控制台”中启用“安装插件文件”脚本步骤。请参阅 Claris Server 和 FileMaker Server 帮助

注释 

  • 系统管理员可以在多个计算机上进行安装期间使用个性化文件,以禁用插件并阻止在 FileMaker Pro 中安装插件更新。请参阅《FileMaker Pro Network 安装设置指南》。

  • FileMaker Cloud 主机执行的服务器端脚本不支持此脚本步骤。

示例 1 

安装“视频”插件。

复制
显示自定义对话框 ["是否要安装最新版的视频插件?"]
If [Get ( 上次选择信息 ) = 1]
    安装插件文件[插件::视频]
End If

示例 2

根据运行此脚本的系统的操作系统和硬件架构,从适当的容器字段安装插件。

复制
设置变量 [ $plugin_json ; 值:Get ( 安装的 FM 插件为 JSON ) ]
设置变量 [ $arch ; 值:JSONGetElement ( $plugin_json ; "environment.architecture" ) ]
设置变量 [ $platform ; 值:GetAsNumber ( JSONGetElement ( $plugin_json ; "environment.platform" ) ) ]

# macOS
If [ $platform = 1 ]
    If [ $arch = "arm64" ]
        # Apple 芯片
        安装插件文件 [ Plugins::macOS_Universal ] 
    Else If [ $arch = "x86_64" 和 IsEmpty ( Plugins::macOS_Universal ) ]
        # Intel 和非通用插件可用
        安装插件文件 [ Plugins::macOS_Intel ] 
    Else 
        # Intel 和通用插件可用
        安装插件文件 [ Plugins::macOS_Universal ] 
    End If 
    退出脚本 [ 文本结果:"macOS 版插件已安装" ] 
End If 

# Windows
If [ $platform = -2 ]
    安装插件文件 [ Plugins::Windows_64bit ] 
    退出脚本 [ 文本结果:"Windows 版插件已安装" ] 
End If 

# Linux
If [ $platform = 5 ]
    If [ PatternCount ( Get (主机应用程序版本) ; "Cloud Server 2" ) > 0 ]
    Else 
        安装插件文件 [ Plugins::Linux ] 
        退出脚本 [ 文本结果:"Linux 版插件已安装" ] 
    End If 
End If 

显示自定义对话框 [ "此平台不支持插件。" ]

示例 3 

请参阅插件更新示例