AppCode 2023.1 Help

Create live templates

The following example procedure illustrates how to create a template for a TODO comment with the current date and user name.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Live Templates.

  2. Select the template group where you want to create a new live template .

    If you do not select a template group, the live template will be added to the user group.

  3. Click the Add button and select Live Template.

  4. Specify the context in which the template will be available. By default, no context is specified and AppCode displays a message at the bottom of the dialog:

    No available context message

    Click Define below the message and select the checkboxes next to applicable contexts:

    Create live template: specify the applicable context
  5. In the Abbreviation field, specify the characters that will be used to expand the template. For example: todo.

  6. (Optional) In the Description field, describe the template for reference in the future.

    For example: Insert TODO comment with the current date and username

  7. In the Template text field, specify the body of the template with variables.

    For example: //TODO $DATE$ $USER$: $END$

  8. Click Edit variables to define the variables using functions:

    Name

    Expression

    Default value

    Skip if defined

    DATE

    date()

    None

    Yes

    USER

    user()

    None

    Yes

    You can set a default value for cases when the expression fails to evaluate, although these particular functions should always return a valid value. You can also disable the Skip if defined option for a variable to highlight the expanded value and let the user modify it if necessary.

  9. Apply all your changes.

  10. In the editor, type todo and press Tab.

    Depending on the current system date and username, the template should expand to something like:

    //TODO 2019-07-02 jsmith:

Create a surround live template

In this example, we will create surround live templates for VStack and HStack SwiftUI-elements.

  1. In the Settings dialog Ctrl+Alt+S, go to Editor | Live Templates.

  2. Press Alt+Insert or click the Add button and select Template Group. In the dialog that opens, enter the group name, for example SwiftUI.

  3. Select the new group in the list, press Alt+Insert, and select Live Template.

  4. In the Abbreviation field, enter a short set of letters that you will use to insert the template on the page, for example, vs for VStack. In the Description field, explain what the abbreviation stands for. In the Template Text area, add the code:

    VStack { $SELECTION$ }

    Click the Define link and select the Swift context:

    Surround template
  5. Select the newly created template in the list and click the Copy button — a copy of the template will be created. Replace VStack with HStack in code and description, add the hs abbreviation, and click OK.

  6. In the editor, select the code that you want to wrap with the newly created template, press Ctrl+Alt+T, and choose the desired template from the list:

    Surround code with the live template

Create a new template from a fragment of code

  1. In the editor, select the text fragment to create a live template from.

  2. Select Code | Save as Live Template... from the main menu. The list of the live templates opens. In this list, the newly created template has been added to the user group.

  3. Specify an abbreviation for the template, an optional description (to identify what the template is for) and modify the template body. If the template has variables defined, click Edit Variables to configure them.

  4. Click OK to apply the changes.

Copy an existing template

If you want to reuse the same template in multiple groups, or you want to create a new template based on another one, you can duplicate an existing template.

  1. On the Editor | Live Templates page of the Preferences dialog (Ctrl+Alt+S), select the template you want to copy.

  2. Click Duplicate The Duplicate button on the toolbar. A new template item is added to the same group as the original, and selected.

  3. Specify a new abbreviation for the template, an optional description (to identify what the template is for), and modify the template body if necessary. If the template has variables defined, click Edit Variables to configure them.

  4. Click OK to apply the changes.

Last modified: 02 March 2023