Πώς να καθαρίσετε με ασφάλεια την cache του Swift Package Manager

Το SwiftPM έχει περισσότερες από μία cache

Ένα package γραμμής εντολών κρατά checkouts, αποθετήρια, προϊόντα build και την κατάσταση του workspace στον φάκελο .build, ενώ το SwiftPM διατηρεί και μια κοινόχρηστη cache αποθετηρίων, ώστε τα projects να μην κατεβάζουν κάθε φορά τις ίδιες εξαρτήσεις. Το Xcode συνδέει συνήθως τα checkouts και τα προϊόντα των packages με το DerivedData του project. Καθαρίστε το στενότερο επίπεδο που εξηγεί το πρόβλημα.

Επιλέξτε την εντολή με βάση το εύρος

Το swift package clean αφαιρεί τα τεχνουργήματα build του τρέχοντος package. Το reset είναι ευρύτερο: επαναφέρει ολόκληρη την cache και τον φάκελο build του package, οπότε εξαρτήσεις και κατάσταση workspace προετοιμάζονται ξανά. Το purge-cache αδειάζει την καθολική cache αποθετηρίων που μοιράζονται τα projects, οπότε η επόμενη επίλυση ή το επόμενο build μπορεί να χρειαστεί δίκτυο και περισσότερο χρόνο σε πολλά αποθετήρια.

1. Κάντε commit ή stash τις αλλαγές σας και επιβεβαιώστε ότι τα Package.swift και Package.resolved βρίσκονται εκεί που τα περιμένει το project.
2. Από τη ρίζα του package εκτελέστε swift package clean και δοκιμάστε ξανά το αρχικό build.
3. Αν το τοπικό workspace του package παραμένει ασυνεπές, εκτελέστε swift package reset και κάντε ξανά επίλυση και build.
4. Εκτελέστε swift package purge-cache μόνο αν η κοινόχρηστη cache αποθετηρίων είναι υπερβολικά μεγάλη ή κατεστραμμένη.
5. Επαληθεύστε το γράφημα εξαρτήσεων και το build πριν καθαρίσετε DerivedData του Xcode.

Οι διαθέσιμες υποεντολές εξαρτώνται από το εγκατεστημένο toolchain της Swift· εκτελέστε swift package --help για να τις επιβεβαιώσετε σε αυτό το Mac.

Κρατήστε το Package.resolved, εκτός αν θέλετε νέες εκδόσεις

Το Package.resolved καταγράφει τις εκδόσεις που επιλύθηκαν. Αν το διαγράψετε, η επόμενη επίλυση μπορεί να επιλέξει άλλες εκδόσεις που επιτρέπει το Package.swift και ο καθαρισμός να γίνει σιωπηλά αναβάθμιση εξαρτήσεων. Τα Package.swift, Sources, Tests, plugins και οι τοπικές εξαρτήσεις είναι πηγαίος κώδικας, όχι cache.

Τα packages του Xcode θέλουν χωριστή αντιμετώπιση

Αν το πρόβλημα εμφανίζεται μόνο στο Xcode, δοκιμάστε το File > Packages > Reset Package Caches και μετά το File > Packages > Resolve Package Versions (τα ονόματα των μενού διαφέρουν ανά έκδοση) ή διαγράψτε μόνο τον φάκελο DerivedData εκείνου του project. Για έλλειψη χώρου, μετρήστε τους φακέλους .build πριν από οποιοδήποτε καθολικό purge. Το AskClean δείχνει ποια κατηγορία πιάνει χώρο· το εύρος του καθαρισμού το ορίζουν οι εντολές της Swift.

Σύγκριση αποφάσεων και κινδύνων

Καθαρίστε με ασφάλεια την cache του Swift Package Manager (SPM): πότε χρειάζεται swift package clean, reset ή purge-cache και γιατί κρατάτε το Package.resolved.

Συχνές ερωτήσεις