No Objetivo C, posso usar #pragma markpara marcar seções do meu código no navegador de símbolos. Como esse é um comando do pré-processador C, não está disponível no Swift. Existe um substituto para isso no Swift, ou eu tenho que usar comentários feios?

Você pode usar // MARK:

Também se discutiu que o uso liberal de extensões de classe pode ser uma prática melhor de qualquer maneira. Como as extensões podem implementar protocolos, você pode, por exemplo, colocar todos os seus métodos de delegação de exibição de tabela em uma extensão e agrupar seu código em um nível mais semântico do que #pragma marké capaz.

Até o Xcode 5, a diretiva de pré-processador #pragma markexistia.

A partir do Xcode 6, você deve usar // MARK:

Esses recursos do pré-processador permitem trazer alguma estrutura para a caixa suspensa da função do editor de código-fonte.

alguns exemplos :

// MARK:

-> será precedido por um divisor horizontal

// MARK: your text goes here

-> coloca 'seu texto aqui' em negrito na lista suspensa

// MARK: - your text goes here

-> coloca 'seu texto aqui' em negrito na lista suspensa, precedido por um divisor horizontal

update: screenshot adicionado porque algumas pessoas ainda parecem ter problemas com isso:

Para quem estiver interessado em usar extensões vs marcas pragma (como mencionado no primeiro comentário), veja como implementá-lo a partir de um Swift Engineer:

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
    }

}

Também não é necessariamente a melhor prática, mas é assim que você faz, se quiser.

Pragma mark - [SOME TEXT HERE]foi usado no Objective-C para agrupar várias funções juntas por separação de linha.

No Swift, você pode conseguir isso usandoMARK, TODO OR FIXME

Eu. MARCA: //MARK: viewDidLoad

Isso criará uma linha horizontal com funções agrupadas em viewDidLoad (mostrado na captura de tela 1)

ii. FAÇAM : //TODO: - viewDidLoad

Isso agrupará a função na TODO: - categoria viewDidLoad (mostrada na captura de tela 2)

iii. FIXME: //FIXME - viewDidLoad

Isso agrupará a função no FIXME: - categoria viewDidLoad (mostrada na captura de tela 3)

Consulte esta documentação da apple para obter detalhes.

Documentação oficial

Documento oficial da Apple sobre o Xcode Jump Bar: adicione anotações de código à barra de salto

Capturas de tela da barra de salto para código de exemplo

Comportamento no Xcode 10.1 e no macOS 10.14.3 (Mojave)

Comportamento no Xcode 10.0 e no macOS 10.13.4 (High Sierra)

Comportamento no Xcode 9.4.1 e no macOS 10.13.0

Discussão

!!!:e ???:às vezes não podem ser exibidos.

No código Objective-C, o Xcode detecta comentários como o // MARK: - fooque é um pouco mais portátil do que #pragma. Mas estes também não parecem ser apanhados (ainda?).

Edit: Corrigido no Xcode 6 beta 4.

Eu acho que Extensionsé uma maneira melhor em vez de #pragma mark.

O 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) {
        ...
    }
}

O código após o uso 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) {
       ...
    }
}

O Xcode 8 agora lida com o seguinte e aparece desta forma no menu suspenso do método:

Confirmado com um engenheiro da Apple no laboratório Swift hoje de manhã na WWDC que atualmente não há nenhum #pragma ou equivalente no momento, eles consideram isso um bug, e ele chegará em breve.

Enfim, está a caminho.

O Xcode agora suporta os marcos // MARK :, // TODO: e // FIXME para anotar seu código e listá-los na barra de salto

Existem três opções para adicionar #pragma_markno Swift:

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Nota: Utiliza -para adicionar separadores

Usar

// MARK: SectionName

ou

// MARK: - SectionName

Isso dará uma linha acima da marca pragma, tornando-a mais legível.

Para facilitar, basta adicionar

// MARK: - <#label#>

aos seus snippets de código.

Caminho alternativo -

Use-o desta maneira

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

Isso não apenas adicionará uma marca (como a marca pragma), mas também segregará bem o código.

//# MARK: - Spinner Class Methods

Adicione uma linha entre os dois pontos e sua descrição para inserir uma linha separadora. Isso ajuda a organizar seu código ainda mais. O código e a captura de tela acima fazem uso do comentário MARK com uma linha incluída.

1. // # MARK: - Métodos de texto (LINE)
2. // # MARK: métodos de texto (NO LINE)

Isso funciona apenas com o comentário MARK.

Você também pode estar interessado em diretivas do compilador Swift 4.2 / XCode 10 como

#warning("Some string to display")

e

#error("Some error to display")

Pode ser útil quando você realmente não quer perder algo.

O programador profissional deve usar essa tag para obter um bom código. Também é bom para o trabalho em equipe.

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

É fácil encontrar um método como este

No Xcode 11, eles adicionaram o minimapa, que pode ser ativado Editor -> Minimap.

O Minimap mostrará o texto de cada marca para orientação rápida no código. Cada marca é escrita como// MARK: Variables

//MARK:não parecem trabalhar para mim no Xcode 6.3.2. No entanto, foi o que fiz para fazê-lo funcionar :

1) Código:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) No jump barnada parece mudar ao adicionar o //MARK: comentário. No entanto, se eu clicar no nome mais à direita na barra de salto, no meu caso MainWindowController(with a leading C icon), uma janela pop-up será exibida mostrando os efeitos do comentário // MARK:, ou seja, um cabeçalho que diz "Meus métodos legais":

3) Percebo também que, se eu clicar em um dos métodos do meu código, o método se tornará a entrada mais à direita na barra de salto. Para MainWindowController(with a leading C icon)ser a entrada mais à direita na barra de salto, tenho que clicar no espaço em branco acima dos meus métodos.

A Apple declara na versão mais recente do Building Cocoa Apps ,

O compilador Swift não inclui um pré-processador. Em vez disso, tira proveito dos atributos em tempo de compilação, configurações de compilação e recursos de idioma para obter a mesma funcionalidade. Por esse motivo, as diretivas de pré-processador não são importadas no Swift.

O caractere # parece ainda ser como você trabalha com várias configurações de compilação e coisas assim, mas parece que eles estão tentando reduzir sua necessidade de pré-processamento na veia do pragma e encaminhá-lo para outros recursos de idioma. Talvez isso ajude na operação dos Playgrounds e no REPL se comportando o mais próximo possível do código totalmente compilado.

Adicionar um item de tarefa: insira um comentário com o prefixo TODO :. Por exemplo: // TODO: [seu item de pendências].

Adicione um lembrete de correção de bug: insira um comentário com o prefixo FIXME :. Por exemplo: // FIXME: [seu lembrete de correção de bug].

Adicione um cabeçalho: insira um comentário com o prefixo MARK :. Por exemplo: // MARK: [seu cabeçalho de seção].

Adicionar uma linha separadora: Para adicionar um separador acima de uma anotação, adicione um hífen (-) antes da parte do comentário da anotação. Por exemplo: // MARK: - [seu conteúdo]. Para adicionar um separador abaixo de uma anotação, adicione um hífen (-) após a parte do comentário da anotação. Por exemplo: // MARK: [seu conteúdo] -.

Tente o seguinte:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

A marca Pragma é uma maneira de melhorar a legibilidade do seu código. Os comentários pragma apareceriam como tags na barra de jumpers do Xcode.

//MARK:  <Your comment goes here>

Exemplo: no código,

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

É assim que apareceria na barra de salto do Xcode.