信赖项目

提示

这部分的API在 2021.2.4/2021.3.1 及之后的版本中才有效。 具体可以查看产品文档：Project Security

当在IDE 中第一次打个某个项目的时候，IDE会询问用户是否信赖该项目。如果用户选择了在安全模式中预览项目，则不会自动执行某些具有潜在危险的功能。

插件可以通过Kotlin 的 Project.isTrusted() 或JAVA的 TrustedProjects.isTrusted(Project) 方法来判断该项目是否已被用户信赖。

在安全模式下打开的项目，可以通过点击编辑器顶部通知面板上的 Trust Project 链接来信赖项目；安全模式下，用户执行了某个危机的操作，该操作也会询问用户是否信赖项目。

插件可以通过订阅 应用级监听器 TrustStateListener 并重写 TrustStateListener.onProjectTrusted() 方法来监听项目是否已被信赖，同时也可以在用户点击信赖项目的时候启用安全模式禁用的功能。也可以使用更好的监听方式：使用TrustedProjects.whenProjectTrusted() 方法。

功能是否危险

如果某一个功能会在后台执行恶意代码，那么必须在安全模式下禁用此功能，并且必须通过用户确认才能启用它。

例如：

• 在IDE中打开一个文件夹的时候自动执行了 Gradle 构建脚本，Gradle 构建脚本可能会执行项目中的恶意代码，所以需要在安全模式下禁用 Gradle 导入功能。