En el Objetivo C, puedo usar #pragma markpara marcar secciones de mi código en el navegador de símbolos. Como se trata de un comando de preprocesador en C, no está disponible en Swift. ¿Hay un sustituto para esto en Swift, o tengo que usar comentarios feos?

Puedes usar // MARK:

También se ha discutido que el uso liberal de las extensiones de clase podría ser una mejor práctica de todos modos. Dado que las extensiones pueden implementar protocolos, puede, por ejemplo, poner todos los métodos de delegado de vista de tabla en una extensión y agrupar su código a un nivel más semántico de lo que #pragma markes capaz.

Hasta Xcode 5 #pragma markexistía la directiva de preprocesador .

A partir de Xcode 6, debes usar // MARK:

Estas características de preprocesador permiten aportar cierta estructura al cuadro desplegable de funciones del editor de código fuente.

algunos ejemplos :

// MARK:

-> estará precedido por un divisor horizontal

// MARK: your text goes here

-> pone 'su texto va aquí' en negrita en la lista desplegable

// MARK: - your text goes here

-> pone 'su texto va aquí' en negrita en la lista desplegable, precedido por un divisor horizontal

actualización: captura de pantalla agregada porque algunas personas todavía parecen tener problemas con esto:

Para aquellos que estén interesados ​​en usar extensiones vs marcas de pragma (como se menciona en el primer comentario), a continuación se explica cómo implementarlo desde un ingeniero de Swift:

import UIKit

class SwiftTableViewController: UITableViewController {

    init(coder aDecoder: NSCoder!) {
        super.init(coder: aDecoder)

    }

    override func viewDidLoad() {
        super.viewDidLoad()

    }
}

extension SwiftTableViewController {
    override func numberOfSectionsInTableView(tableView: UITableView?) -> Int {
        return 1
    }

    override func tableView(tableView: UITableView?, numberOfRowsInSection section: Int) -> Int {
        return 5
    }

    override func tableView(tableView: UITableView?, cellForRowAtIndexPath indexPath: NSIndexPath?) -> UITableViewCell? {
        let cell = tableView?.dequeueReusableCellWithIdentifier("myCell", forIndexPath: indexPath) as UITableViewCell;

        cell.textLabel.text = "Hello World"

        return cell
    }

}

Tampoco es necesariamente la mejor práctica, pero así es como lo haces si quieres.

Pragma mark - [SOME TEXT HERE]se usó en Objective-C para agrupar varias funciones juntas separando líneas.

En Swift puedes lograr esto usandoMARK, TODO OR FIXME

yo. MARCA : //MARK: viewDidLoad

Esto creará una línea horizontal con funciones agrupadas en viewDidLoad (se muestra en la captura de pantalla 1)

ii) QUE HACER : //TODO: - viewDidLoad

Esto agrupará la función en TODO: - categoría viewDidLoad (se muestra en la captura de pantalla 2)

iii) ARREGLARME : //FIXME - viewDidLoad

Esto agrupará la función en FIXME: - categoría viewDidLoad (se muestra en la captura de pantalla 3)

Consulte esta documentación de Apple para más detalles.

Documentación oficial

Documento oficial de Apple sobre Xcode Jump Bar: agregue anotaciones de código a la barra de salto

Capturas de pantalla de Jump Bar para código de muestra

Comportamiento en Xcode 10.1 y macOS 10.14.3 (Mojave)

Comportamiento en Xcode 10.0 y macOS 10.13.4 (High Sierra)

Comportamiento en Xcode 9.4.1 y macOS 10.13.0

Discusión

!!!:y a ???:veces no se pueden mostrar.

En el código Objective-C, Xcode detecta comentarios como los // MARK: - fooque son un poco más portátiles que #pragma. Pero estos tampoco parecen ser recogidos (¿todavía?).

Editar: corregido en Xcode 6 beta 4.

Creo que Extensionses una mejor manera en lugar de #pragma mark.

El código antes de usar Extensions:

class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate {
    ...

    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
        ...
    }
}

El código después de usar Extensions:

class ViewController: UIViewController {
    ...
}

extension ViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }
}

extension ViewController: UICollectionViewDelegate {
    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
       ...
    }
}

Xcode 8 ahora lo maneja de la siguiente manera y se muestra así en el menú desplegable del método:

Confirmado con un ingeniero de Apple en el laboratorio Swift esta mañana en WWDC que actualmente no hay ningún #pragma o equivalente en este momento, lo consideran un error, y llegará pronto, así que supongo que beta 2, espero.

De todos modos, está en camino.

Xcode ahora admite // MARK :, // TODO: y // FIXME hitos para anotar su código y enumerarlos en la barra de salto

Hay tres opciones para agregar #pragma_marken Swift:

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Nota: Usos -para agregar separadores

Utilizar

// MARK: SectionName

o

// MARK: - SectionName

Esto dará una línea sobre la marca pragma, haciéndola más legible.

Para mayor comodidad solo agregue

// MARK: - <#label#>

a sus fragmentos de código.

Forma alternativa -

Úselo de esta manera

private typealias SectionName = ViewController
private extension SectionName  {
    // Your methods
}

Esto no solo agregará la marca (al igual que la marca pragma) sino que también segregará el código muy bien.

//# MARK: - Spinner Class Methods

Agregue una línea entre los dos puntos y su descripción para insertar una línea de separación. Esto ayuda a organizar su código aún más. El código y la captura de pantalla anteriores hacen uso del comentario MARK con una línea incluida.

1. // # MARK: - Métodos de texto (LINE)
2. // # MARK: Métodos de texto (SIN LÍNEA)

Esto solo funciona con el comentario MARK.

También te pueden interesar las directivas del compilador Swift 4.2 / XCode 10 como

#warning("Some string to display")

y

#error("Some error to display")

Puede ser útil cuando realmente no quieres perderte algo.

El programador profesional debe usar esta etiqueta para obtener un buen código. También es bueno para el trabajo en equipo.

// MARK: example Web Service start here
// TODO: example 1
// FIXME: Please change BASE url before live 

Es fácil encontrar un método como este

En Xcode 11 agregaron un minimapa que se puede activar Editor -> Minimap.

El minimapa mostrará el texto de cada marca para una orientación rápida en el código. Cada marca está escrita como// MARK: Variables

//MARK:no parece funcionar para mí en Xcode 6.3.2. Sin embargo, esto es lo que hice para que funcione :

1) Código:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) En la jump barnada parece cambiar al agregar el //MARK: comentario. Sin embargo, si hago clic en el nombre de la derecha en la barra de salto, en mi caso dice MainWindowController(with a leading C icon), aparecerá una ventana emergente que muestra los efectos del comentario // MARK: un encabezado que dice "Mis métodos geniales":

3) También noto que si hago clic en uno de los métodos en mi código, entonces el método se convierte en la entrada más a la derecha en la barra de salto. Para llegar MainWindowController(with a leading C icon)a ser la entrada más a la derecha en la barra de salto, tengo que hacer clic en el espacio en blanco sobre mis métodos.

Apple declara en la última versión de Building Cocoa Apps ,

El compilador Swift no incluye un preprocesador. En cambio, aprovecha los atributos en tiempo de compilación, las configuraciones de compilación y las características del lenguaje para lograr la misma funcionalidad. Por este motivo, las directivas de preprocesador no se importan en Swift.

Parece que el carácter # sigue siendo la forma en que trabaja con varias configuraciones de compilación y cosas por el estilo, pero parece que están tratando de reducir su necesidad de la mayor parte del preprocesamiento en la línea de pragma y remitirlo a otras funciones de lenguaje por completo. Quizás esto sea para ayudar en el funcionamiento de los Playgrounds y el REPL comportándose lo más cerca posible del código completamente compilado.

Agregue un elemento de tarea pendiente: inserte un comentario con el prefijo TODO :. Por ejemplo: // TODO: [su tarea pendiente].

Agregue un recordatorio de corrección de errores: inserte un comentario con el prefijo FIXME :. Por ejemplo: // FIXME: [su recordatorio de corrección de errores].

Agregue un encabezado: inserte un comentario con el prefijo MARK :. Por ejemplo: // MARK: [el encabezado de su sección].

Agregar una línea de separación: para agregar un separador sobre una anotación, agregue un guión (-) antes de la parte de comentario de la anotación. Por ejemplo: // MARK: - [su contenido]. Para agregar un separador debajo de una anotación, agregue un guión (-) después de la parte de comentario de la anotación. Por ejemplo: // MARK: [su contenido] -.

Prueba esto:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

La marca Pragma es una forma de mejorar la legibilidad de su código. Los comentarios de pragma aparecerían como etiquetas en la barra de salto Xcode.

//MARK:  <Your comment goes here>

Ejemplo: en el código,

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

Así es como aparecería en la barra de salto Xcode.