Objective C'de, #pragma markkodumun bölümlerini sembol gezgininde işaretlemek için kullanabilirim . Bu bir C önişlemci komutu olduğundan, Swift'te mevcut değildir. Swift'te bunun için bir stand-in var mı, yoksa çirkin yorumlar kullanmak zorunda mıyım?

Kullanabilirsiniz // MARK:

Sınıf uzantılarının liberal kullanımının yine de daha iyi bir uygulama olabileceği konusunda tartışmalar olmuştur. Uzantılar protokolleri uygulayabildiğinden, örneğin tüm tablo görünümü delege yöntemlerinizi bir uzantıya koyabilir ve kodunuzu #pragma markyapabileceğinden daha anlamsal bir düzeyde gruplandırabilirsiniz .

Xcode 5'e kadar önişlemci direktifi #pragma markvardı.

Xcode 6'dan itibaren, // MARK:

Bu önişlemci özellikleri, kaynak kodu düzenleyicisinin işlev açılır kutusuna bazı yapıların getirilmesine izin verir.

bazı örnekler :

// MARK:

-> öncesinde bir yatay bölücü bulunacaktır

// MARK: your text goes here

-> 'metniniz buraya gelir' seçeneğini açılır listeye kalın olarak yerleştirir

// MARK: - your text goes here

-> 'metniniz buraya gider' ifadesini, önce yatay bir bölücü ile açılan listeye kalın olarak yerleştirir

güncelleme: ekran görüntüsü eklendi 'bazı insanlar hala bununla ilgili sorunlar yaşıyor gibi görünüyor:

Uzantıları ve pragma işaretlerini (ilk yorumda belirtildiği gibi) kullanmak isteyenler için, bir Swift Mühendisinden nasıl uygulanacağı aşağıda açıklanmıştır:

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
    }

}

Ayrıca mutlaka en iyi uygulama değildir, ancak isterseniz bunu böyle yaparsınız.

Pragma mark - [SOME TEXT HERE]Objective-C'de birkaç işlevi birlikte gruplandırmak için kullanıldıHat-ayırarak .

In Swift kullanmakta bunu başarabilirsinizMARK, TODO OR FIXME

ben. İŞARET : //MARK: viewDidLoad

Bu, viewDidLoad altında gruplandırılmış işlevlerle yatay bir çizgi oluşturur (ekran görüntüsü 1'de gösterilir)

ii. YAPMAK : //TODO: - viewDidLoad

Bu, işlevi YAPILACAKLAR altında gruplayacaktır : - viewDidLoad kategorisi (ekran görüntüsü 2'de gösterilmiştir)

iii. DÜZELT BENİ : //FIXME - viewDidLoad

Bu, FIXME altında işlevi gruplandıracaktır : - viewDidLoad kategorisi (ekran görüntüsü 3'te gösterilmiştir)

Ayrıntılar için bu elma belgelerine bakın.

Resmi Belgeler

Apple'ın Xcode Jump Bar ile ilgili resmi belgesi: Jump çubuğuna kod ek açıklamaları ekleyin

Örnek Kod için Jump Bar Ekran Görüntüleri

Xcode 10.1 ve macOS 10.14.3 (Mojave) 'de davranış

Xcode 10.0 ve macOS 10.13.4 (Yüksek Sierra) davranışları

Xcode 9.4.1 ve macOS 10.13.0'daki davranış

Tartışma

!!!:ve ???:bazen görüntülenemez.

Objective-C kodu Xcode // MARK: - foobiraz daha taşınabilir gibi yorumlar algılar#pragma . Ama bunlar da henüz toplanmış gibi görünmüyor (henüz?).

Düzenleme: Xcode 6 beta 4'te düzeltildi.

Bence bunun Extensionsyerine daha iyi bir yol#pragma mark .

Kullanmadan önce Kod 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) {
        ...
    }
}

Kullandıktan sonra kod 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 şimdi aşağıdaki gibi işliyor ve yöntem açılır penceresinde şu şekilde görünüyor:

Şu anda WWDC'de Swift laboratuvarında bir Apple Mühendisi ile şu anda herhangi bir #pragma veya eşdeğeri olmadığını doğruladılar, bunu bir hata olarak görüyorlar ve yakında gelecek, bu yüzden beta 2'yi tahmin ediyorum, umarım.

Her neyse, yolda.

Xcode artık kodunuza açıklama eklemek ve atlama çubuğunda listelemek için // MARK :, // TODO: ve // ​​FIXME yer işaretlerini destekliyor

#pragma_markSwift'e eklemek için üç seçenek vardır :

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Not: -Ayırıcı eklemek için kullanır

kullanım

// MARK: SectionName

veya

// MARK: - SectionName

Bu, pragma işaretinin üzerinde bir çizgi verecek ve daha okunabilir hale getirecektir.

Kolaylık için sadece ekleyin

// MARK: - <#label#>

kod snippet'lerinize.

Alternatif yol -

Bu şekilde kullanın

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

Bu sadece işaret eklemekle kalmayacak (pragma işareti gibi), aynı zamanda kodu da güzelce ayıracaktır.

//# MARK: - Spinner Class Methods

Bir ayırıcı çizgi eklemek için iki nokta üst üste ve açıklamanız arasına bir satır ekleyin. Bu, kodunuzu daha da düzenlemenize yardımcı olur. Yukarıdaki kod ve ekran görüntüsü, bir satır dahil MARK yorumundan yararlanır.

1. // # MARK: - Metin Yöntemleri (LINE)
2. // # MARK: Metin Yöntemleri (HAT YOK)

Bu sadece MARK yorumu ile çalışır.

Ayrıca ilginizi çekebilir Swift 4.2 / XCode 10 derleyici yönergeleri gibi

#warning("Some string to display")

ve

#error("Some error to display")

Gerçekten bir şey kaçırmak istemediğinizde yararlı olabilir.

Profesyonel programcı iyi etiket için bu etiketi kullanmalıdır. Ekip çalışması için de iyidir.

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

Bunun gibi bir yöntem bulmak kolaydır

Xcode 11'de etkinleştirilebilen mini harita eklediler Editor -> Minimap.

Mini harita, kodda hızlı yönlendirme için her işaret metnini gösterecektir. Her işaret şöyle yazılır// MARK: Variables

//MARK:değil gibi görünüyor Xcode 6.3.2 benim için işe. Ancak, bu işe almak için yaptım :

1) Kod:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) : Yorum jump bareklenirken hiçbir şey değişmez //MARK. Ancak, atlama çubuğundaki en sağdaki adı tıklarsam, benim durumumda MainWindowController(with a leading C icon), // MARK: yorumunun, yani "Benim serin yöntemlerim" yazan bir başlığın etkilerini gösteren bir açılır pencere görüntülenecektir:

3) Ayrıca, kodumdaki yöntemlerden birine tıklarsam, yöntemin atlama çubuğundaki en sağdaki giriş haline geldiğini fark ettim. Almak için MainWindowController(with a leading C icon)atlama çubuğunda en sağdaki giriş olması, benim yöntemlerle yukarıdaki boşluk tıklamanız gerekiyor.

Apple, Building Cocoa Apps'ın son sürümünde ,

Swift derleyicisi bir önişlemci içermez. Bunun yerine, aynı işlevselliği gerçekleştirmek için derleme zamanı özelliklerinden, derleme yapılandırmalarından ve dil özelliklerinden yararlanır. Bu nedenle, önişlemci yönergeleri Swift'e aktarılmaz.

# Karakteri hala çeşitli yapı yapılandırmaları ve bunun gibi şeylerle nasıl çalıştığınız gibi görünüyor, ancak pragma damarındaki çoğu ön işleme ihtiyacınızı azaltmaya ve sizi diğer dil özelliklerine iletmeye çalışıyor gibi görünüyor. Belki de bu, Oyun Alanlarının işleyişine ve REPL'nin tamamen derlenmiş koda mümkün olduğunca yakın davranmasına yardımcı olmaktır.

Yapılacaklar öğesi ekleme: TODO: önekiyle bir yorum ekleyin. Örneğin: // YAPILACAKLAR: [yapılacaklar öğeniz].

Hata düzeltme hatırlatıcısı ekleme: FIXME: önekiyle bir yorum ekleyin. Örneğin: // FIXME: [hata düzeltme hatırlatıcınız].

Başlık ekleyin: MARK: önekiyle bir yorum ekleyin. Örneğin: // MARK: [bölüm başlığınız].

Ayırıcı satır ekleme: Ek açıklamanın üstüne ayırıcı eklemek için ek açıklamanın yorum kısmından önce bir tire işareti (-) ekleyin. Örneğin: // MARK: - [içeriğiniz]. Bir notun altına ayırıcı eklemek için, notun yorum kısmından sonra bir tire işareti (-) ekleyin. Örneğin: // MARK: [içeriğiniz] -.

Bunu dene:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

Pragma mark, kodunuzun okunabilirliğini artırmanın bir yoludur. Pragma yorumları Xcode jumpbar'daki etiketler gibi görünecektir.

//MARK:  <Your comment goes here>

Örnek: Kodda,

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

Xcode atlama çubuğunda böyle görünecektir.