W celu C mogę używać #pragma markdo zaznaczania części mojego kodu w nawigatorze symboli. Ponieważ jest to polecenie preprocesora języka C, nie jest ono dostępne w Swift. Czy w Swift jest na to jakieś rozwiązanie, czy też muszę używać brzydkich komentarzy?

Możesz użyć // MARK:

Dyskutowano również, że swobodne stosowanie rozszerzeń klas może być lepszą praktyką. Ponieważ rozszerzenia mogą implementować protokoły, możesz np. Umieścić wszystkie metody delegowania widoku tabeli w rozszerzeniu i pogrupować kod na poziomie bardziej semantycznym niż #pragma markjest to możliwe.

Do Xcode 5 #pragma markistniała dyrektywa preprocesora .

Od Xcode 6 musisz korzystać // MARK:

Te funkcje preprocesora pozwalają wprowadzić pewną strukturę do pola rozwijanego funkcji edytora kodu źródłowego.

kilka przykładów :

// MARK:

-> będzie poprzedzony dzielnikiem poziomym

// MARK: your text goes here

-> umieszcza „Twój tekst idzie tutaj” pogrubioną czcionką na liście rozwijanej

// MARK: - your text goes here

-> umieszcza „Twój tekst idzie tutaj” pogrubioną czcionką na liście rozwijanej, poprzedzoną poziomym dzielnikiem

aktualizacja: dodano zrzut ekranu, ponieważ niektóre osoby nadal wydają się mieć z tym problemy:

Dla tych, którzy są zainteresowani użyciem rozszerzeń kontra znaczniki pragma (jak wspomniano w pierwszym komentarzu), oto jak zaimplementować je od inżyniera 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
    }

}

To niekoniecznie najlepsza praktyka, ale tak to robisz, jeśli chcesz.

Pragma mark - [SOME TEXT HERE]został użyty w celu C do zgrupowania kilku funkcji razem poprzez rozdzielenie linii.

W Swift możesz to osiągnąć za pomocąMARK, TODO OR FIXME

ja. ZNAK : //MARK: viewDidLoad

Spowoduje to utworzenie poziomej linii z funkcjami zgrupowanymi pod viewDidLoad (pokazane na zrzucie ekranu 1)

ii. DO ZROBIENIA : //TODO: - viewDidLoad

Spowoduje to zgrupowanie funkcji w ramach TODO: - kategoria viewDidLoad (pokazana na zrzucie ekranu 2)

iii. NAPRAW MNIE : //FIXME - viewDidLoad

Spowoduje to zgrupowanie funkcji w ramach FIXME: - kategoria viewDidLoad (pokazana na zrzucie ekranu 3)

Sprawdź szczegóły w dokumentacji Apple .

Oficjalna dokumentacja

Oficjalny dokument Apple dotyczący paska skoku Xcode: dodaj adnotacje do kodu paska skoku

Zrzuty ekranowe paska skoku dla przykładowego kodu

Zachowanie w Xcode 10.1 i macOS 10.14.3 (Mojave)

Zachowanie w Xcode 10.0 i macOS 10.13.4 (High Sierra)

Zachowanie w Xcode 9.4.1 i macOS 10.13.0

Dyskusja

!!!:i ???:czasami nie mogą być wyświetlane.

W kodzie Objective-C Xcode wykrywa komentarze takie, // MARK: - fooktóre są nieco bardziej przenośne niż #pragma. Ale te też nie wydają się być (jeszcze?) Odebrane.

Edycja: Naprawiono w Xcode 6 beta 4.

Myślę, że Extensionsjest lepszy sposób niż #pragma mark.

Kod przed użyciem 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) {
        ...
    }
}

Kod po użyciu 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 obsługuje teraz go w następujący sposób i pokazuje się tak w menu rozwijanym metody:

Potwierdzony dziś rano przez inżyniera Apple w laboratorium Swift w WWDC, że obecnie nie ma #pragmy lub jej odpowiednika, uważają to za błąd i niedługo nadejdzie, więc mam nadzieję, że beta 2.

W każdym razie jest już w drodze.

Xcode obsługuje teraz punkty orientacyjne // MARK :, // TODO: i // FIXME, aby opisywać kod i wyświetlać je na pasku skoku

Istnieją trzy opcje do dodania #pragma_markw Swift:

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Uwaga: Zastosowania -do dodawania separatorów

Posługiwać się

// MARK: SectionName

lub

// MARK: - SectionName

To da linię powyżej znaku pragma, dzięki czemu będzie bardziej czytelna.

Dla ułatwienia wystarczy dodać

// MARK: - <#label#>

do fragmentów kodu.

Alternatywny sposób -

Użyj tego w ten sposób

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

To nie tylko doda znak (podobnie jak znak pragma), ale także ładnie segreguje kod.

//# MARK: - Spinner Class Methods

Dodaj linię między dwukropkiem a opisem, aby wstawić linię separatora. Pomaga to jeszcze bardziej uporządkować kod. Powyższy kod i zrzut ekranu wykorzystują komentarz MARK z dołączoną linią.

1. // # MARK: - Metody tekstowe (LINIA)
2. // # MARK: Metody tekstowe (NO LINE)

Działa to tylko z komentarzem MARK.

Możesz być także zainteresowany dyrektywami kompilatora Swift 4.2 / XCode 10, takimi jak

#warning("Some string to display")

i

#error("Some error to display")

Może to być przydatne, gdy naprawdę nie chcesz czegoś przegapić.

Profesjonalny programista musi używać tego znacznika, aby uzyskać dobry kod. Jest również dobry do pracy zespołowej.

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

Łatwo jest znaleźć taką metodę

W Xcode 11 dodali minimapę, którą można aktywować Editor -> Minimap.

Minimapa pokaże każdy znak tekstu w celu szybkiej orientacji w kodzie. Każdy znak jest napisany jak// MARK: Variables

//MARK:nie wydaje mi się działać w Xcode 6.3.2. Jednak tak zrobiłem , aby działało :

1) Kod:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) W jump barnic nie wydaje się zmieniać podczas dodawania //MARK: komentarza. Jeśli jednak kliknę prawą nazwę na pasku skoku, w moim przypadku jest to napisane MainWindowController(with a leading C icon), pojawi się wyskakujące okienko pokazujące efekty komentarza // MARK: komentarz, a mianowicie nagłówek z napisem „Moje fajne metody”:

3) Zauważam również, że jeśli kliknę jedną z metod w moim kodzie, metoda ta stanie się pozycją umieszczoną najbardziej na prawo na pasku skoku. Aby uzyskać MainWindowController(with a leading C icon)pozycję najbardziej na prawo na pasku skoku, muszę kliknąć biały znak nad moimi metodami.

Apple stwierdza w najnowszej wersji Building Cocoa Apps ,

Kompilator Swift nie zawiera preprocesora. Zamiast tego wykorzystuje atrybuty czasu kompilacji, konfiguracje kompilacji i funkcje językowe, aby osiągnąć tę samą funkcjonalność. Z tego powodu dyrektywy preprocesora nie są importowane do Swift.

Wygląda na to, że znak # wciąż działa z różnymi konfiguracjami kompilacji i podobnymi rzeczami, ale wygląda na to, że starają się zmniejszyć potrzebę większości przygotowań wstępnych w stylu pragmy i przekazać ci inne funkcje językowe. Być może ma to pomóc w działaniu Playgrounds, a REPL zachowuje się jak najbliżej w pełni skompilowanego kodu.

Dodaj rzecz do zrobienia: wstaw komentarz z przedrostkiem TODO :. Na przykład: // TODO: [Twoja rzecz do zrobienia].

Dodaj przypomnienie o błędzie: Wstaw komentarz z prefiksem FIXME :. Na przykład: // FIXME: [przypomnienie o błędzie].

Dodaj nagłówek: Wstaw komentarz z prefiksem ZNAK :. Na przykład: // MARK: [nagłówek twojej sekcji].

Dodaj linię separatora: Aby dodać separator powyżej adnotacji, dodaj myślnik (-) przed częścią komentarza adnotacji. Na przykład: // MARK: - [twoja treść]. Aby dodać separator pod adnotacją, dodaj myślnik (-) po części komentarza adnotacji. Na przykład: // MARK: [twoja treść] -.

Spróbuj tego:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

Znak Pragma to sposób na poprawę czytelności kodu. Komentarze pragma wyglądałyby jak tagi na pasku skoku Xcode.

//MARK:  <Your comment goes here>

Przykład: w kodzie

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

Tak to wyglądałoby na pasku skoku Xcode.