AppCode 2017.2 Help

Applying Patches

Postponed changes stored in a patch file can be applied to the target file or directory later. If the source code was edited after creating the patch, conflicts may arise. AppCode suggests a handy way to resolve such conflicts and merge the patch with the changes.

When a patch is opened, AppCode detects files with the same name as the modified files. For each detected file, AppCode compares the path to it relative to the base directory, with the path from the patch, and chooses the closest match. If no matching path is found, the file is considered to be located in the project base directory and is highlighted in red.

You can apply changes to files stored in different locations from those specified in the patch by mapping an arbitrary directory as the base one, or stripping off the leading directories.

To apply a patch

  1. On the main menu, choose VCS | Apply patch.
  2. In the Apply Patch dialog box that opens, specify the fully qualified name of the patch file. Type the name manually or click the Browse button browseButton.png and locate the desired patch file in the Select Patch File dialog box.

    You can also drag and drop a file or an email attachment to the Apply Patch dialog, and it will be selected automatically.

  3. Configure the patch presentation layout. To have changes shown in a flat view, press the Group by Directory toolbar button /help/img/idea/2017.2/vcsToolbarGroupByDirIcon.png.
    Release the button to have changes shown in a directory tree view.
  4. To have a change applied, select the check box next to it.
  5. To have a change applied to a modified file that has been moved to another location, specify the new file location.
    • To map another base directory, select the desired file, directory, or a group files/directories and click the Map base directory toolbar button /help/img/idea/2017.2/icon_vcs_basic_directory.png. In the dialog that opens choose the directory relative to which file names will be interpreted.
    • To remove leading directories from the path, click the Strip Directory toolbar button /help/img/idea/2017.2/icon_vcs_strip_directory.png as many times as many leading directories you need to strip. The number of removed slashes is indicated in square brackets.
    • To revert the last strip directory action, click the Restore Directory toolbar button /help/img/idea/2017.2/icon_vcs_restore_directory.png. Click the button as many times as many previously stripped leading directories you need to restore.
    • To revert all the strip directory actions in the selection, click the Reset Directories toolbar button /help/img/idea/2017.2/icon_vcs_reset_directories.png.
    • To have all the leading directories stripped and have the changes applied to the file with the specified name in the base directory, click the Remove Directories toolbar button /help/img/idea/2017.2/icon_vcs_remove_directories.png.
  6. To view the differences and possible conflicts between your local working copy, the repository version, and the patch in the Differences Viewer, select the desired change and click the Show Differences button vcsToolbarCompareIcon.gif.
  7. To resolve conflicts between the patched and the current versions, if any, in both versions select the changes to be merged to the resulting file, and then click Apply.

    Note that you apply a patch that contains a lot of files and causes numerous conflicts, you can cancel applying the patch by clicking Abort, and then select whether you want to abort, skip or cancel the remaining conflicts.

See Also

Last modified: 26 July 2017