AppCode 2022.1 Help

Project security

To prevent potential security risks, AppCode lets you decide how to open a project if you're not sure about its source. AppCode warns you about tasks or configurations that will be executed during the opening process and lets you configure sources that you can trust.

Open a project from unknown sources

Xcode projects that you open from unknown sources may contain malicious code in build scripts. Swift packages included in a project, as well as standalone Swift packages, may also contain untrusted code in their scripts.

Untrusted Project

You can select one of the following actions:

  • Preview in Safe Mode: in this case AppCode opens a project in a "preview mode" meaning you can browse the project's sources, but there are restrictions in executing code, performing any build-related activities, or running any scripts.

    For more information on Safe Mode preview limitations, refer to Safe mode preview limitations.

    AppCode displays a notification on top of the editor area, and you can click the Trust project… link and load your project at any time.

  • Trust Project: in this case, AppCode opens and loads a project. That means project is initialized, project's plugins are resolved, dependencies are added, and all AppCode features are available.

  • Don't Open: in this case AppCode cancels the action.

Safe mode preview limitations

If you open a project in the safe mode, the following limitations will apply to the project:

  • Loading, building, and running Swift Packages is not possible.

  • Startup tasks: any scripts or tasks that are executed during the opening process are disabled.

  • VCS support: the whole VCS support is disabled.

  • File Watchers scripts will not wake up and run corresponding tools.

Trusted locations

You can configure what sources AppCode should consider safe and load such projects automatically during the opening process.

You can add your home directory to the trusted locations to disable AppCode's warnings about untrusted projects.

Configure trusted locations

  1. In the Preferences dialog (⌃ ⌥ S), go to Build, Execution, Deployment | Trusted Locations.

  2. On the Trusted Locations settings page, configure the local directories where the projects you consider trusted reside. Click OK to save the changes.

    Trusted Locations

    The next time you open a project from one of those locations, AppCode will automatically load the project.

Last modified: 05 April 2022