Cómo cambiar fácilmente el texto del encabezado del archivo en Xcode

El encabezado predeterminado generado por Xcode

¿Alguna vez ha querido crear su propio texto de encabezado automáticamente cada vez que crea su propio archivo? La página de ayuda de Xcode ya explica cómo hacerlo. Pero hay demasiada información allí para nuevos programadores. Entonces, si estás confundido, ¡sigue este sencillo tutorial!

Que necesitas

Necesitamos dos cosas:

  • Un archivo plist con este nombre: IDETemplateMacros.plist. Crearemos esto.
  • Una ubicación para colocar el archivo de arriba.

Crear el archivo plist

  1. Abrir Xcode.
  2. Crear nuevo archivo, el acceso directo es Comando + N.
  3. Desplácese hacia abajo hasta Archivos de recursos y elija el archivo de tipo Lista de propiedades.
  4. Haga clic en Siguiente y proporcione el nombre de archivo IDETemplateMacros.plist.
  5. Guárdelo en el escritorio por ahora para que podamos encontrarlo fácilmente.

Luego trasladaremos este archivo a un lugar apropiado.

Personalizar la macro de texto

Una vez que cree el archivo plist, es hora de modificar el archivo plist y agregar la clave de macro para el texto del encabezado.

  • Abra el archivo plist que ha creado haciendo doble clic en él. Prefiero usar Xcode como editor de plist.
  • Resalte la fila raíz y haga clic en el signo +.
Agregue una nueva clave haciendo clic en el signo +.
  • Escriba FILEHEADER como nombre de clave y asegúrese de que el tipo sea String.
Escriba FILEHEADER como nombre clave para hacer referencia al texto colocado en la parte superior de cada archivo nuevo.

FILEHEADER es una macro de texto que hace referencia al texto colocado en la parte superior de cada archivo nuevo en Xcode. La ayuda de Xcode tiene la lista de todas las macros si desea obtener más información sobre otras macros.

  • Esta es la parte divertida, crea tu texto de encabezado personalizado en tu editor de texto.

He creado mi propio encabezado personalizado usando TextEdit como se muestra a continuación, puedes escribir cualquier cosa y hacerlo tan bonito como quieras:

Lo importante aquí son las teclas que están rodeadas por tres guiones bajos. PACKAGENAME, FULLUSERNAME y DATE serán reemplazados por XCode con sus valores internos.

Se pueden agregar otras macros de texto: COPYRIGHT, FILEBASENAME, ORGANIZATIONNAME. No olvides rodear las teclas de macro con tres guiones bajos antes y después del texto.

Para obtener la lista completa de macros de texto, consulte la sección de ayuda de Xcode con la palabra clave "Referencia de macros de texto".

  • Después de crear su encabezado personalizado, seleccione Todo y copie el texto.
  • Abra el archivo IDETemplateMacros.plist que ha creado, haga doble clic en la fila de valor y pegue el texto allí. Presione Entrar.

La fila en Xcode plist editor solo puede mostrar una línea, por lo que está bien si solo ve la última línea de su encabezado.

Pegue el encabezado personalizado del editor de texto en la celda de valor.

¡Felicidades! Ha creado su propio texto de encabezado y está listo para usar.

Elegir ubicación para colocar el archivo plist

Ahora, necesitamos poner este archivo en un lugar donde Xcode leerá la macro. Xcode buscará una macro de texto en las siguientes ubicaciones:

  • Datos del usuario del proyecto:

.xcodeproj / xcuserdata / [nombre de usuario] .xcuserdatad /

  • Datos compartidos del proyecto:

.xcodeproj / xcshareddata / IDETemplateMacros.plist

  • Datos de usuario del espacio de trabajo:

.xcworkspace / xcuserdata / [nombre de usuario] .xcuserdatad /

  • Datos compartidos del espacio de trabajo:

.xcworkspace / xcshareddata /

  • Datos Xcode del usuario:

~ / Library / Developer / Xcode / UserData /

Puede colocar el archivo plist que creó en uno de los directorios anteriores. Si trabaja en un proyecto, podría usar el usuario del proyecto o el directorio de datos compartidos. Si trabaja en un espacio de trabajo, podría usar el usuario del espacio de trabajo o los datos compartidos. O, si realmente desea utilizar su encabezado personalizado en todos sus proyectos, puede colocar el archivo plist en el directorio de datos Xcode del usuario.

A continuación se muestra el ejemplo de poner el archivo en un directorio de datos de usuario del proyecto. ¡Y eso es!

Elegir el directorio de datos de usuario del proyecto para la ubicación del archivo plist. (<ProjectName> .xcodeproj / xcuserdata / [nombre de usuario] .xcuserdatad /).

Intentemos

Ahora que todo está hecho. Abra el proyecto o el espacio de trabajo donde coloca el archivo plist. O puede abrir cualquier proyecto si lo coloca en el directorio de datos Xcode del usuario.

¡Crea un nuevo archivo Swift y admira tu trabajo! ¡Es fácil, no!

Si te gusta mi publicación, dale me gusta y comparte. ¡Gracias!