Så rensar du Swift Package Manager-cachen säkert

SwiftPM har flera cachelager

Ett kommandoradspaket har normalt en .build-mapp med checkouts, repositories, byggresultat och arbetsytans tillstånd. SwiftPM har dessutom en delad repository-cache så att flera projekt inte behöver hämta samma beroenden varje gång, och för appar i Xcode hamnar paketens checkouts och byggprodukter i projektets DerivedData. Rensa det smalaste lager som förklarar problemet – en rensning i ett enskilt projekt går snabbare att återställa och påverkar inte andra repositories.

Välj kommando efter omfattning

swift package clean tar bort paketets byggartefakter och är förstahandsvalet vid inaktuella kompileringsresultat eller när du bara vill frigöra utrymme i ett repository. swift package reset återställer paketets hela cache och byggmapp, så beroenden och arbetsytans tillstånd måste förberedas igen. swift package purge-cache tömmer den globala repository-cache som flera projekt delar; nästa beroendeupplösning kan kräva nätverk och ta längre tid i flera repositories.

1. Checka in eller stasha ändringar och kontrollera att Package.swift och Package.resolved finns där projektet förväntar sig.
2. Kör swift package clean i paketets rot och prova det ursprungliga bygget igen.
3. Om paketets lokala arbetsyta fortfarande är inkonsekvent kör du swift package reset och bygger sedan igen, så att beroendena löses på nytt.
4. Kör swift package purge-cache bara om den delade repository-cachen är onormalt stor eller skadad.
5. Kontrollera beroendegrafen och bygget innan du rensar Xcode-specifik DerivedData.

Vilka underkommandon som finns beror på den installerade Swift-verktygskedjan. Kör swift package --help för att se vad som stöds på din Mac.

Behåll Package.resolved

Package.resolved registrerar exakt vilka beroendeversioner som valdes. Tar du bort filen kan nästa upplösning välja andra versioner som Package.swift tillåter, och rensningen blir i praktiken en uppgradering. Ta bara bort den när du medvetet vill att versionerna ska väljas på nytt. Package.swift, Sources, Tests, insticksprogram och lokala beroenden är källfiler, inte cache: genererat .build-innehåll kommer tillbaka, men det du själv har skrivit gör inte det.

Hantera Swift-paket i Xcode separat

Vid problem som bara syns i Xcode börjar du med File > Packages > Reset Package Caches och sedan File > Packages > Resolve Package Versions; menynamnen kan variera mellan Xcode-versioner. Hänger problemet ihop med kompilerade paketartefakter tar du bort just det projektets DerivedData, inte hela DerivedData-mappen. Spara det ursprungliga felmeddelandet först: autentiseringsfel, otillgängliga Git-värdar och ändrade checksummor försvinner inte för att hämtningar raderas. AskClean visar kategorierna runt SwiftPM, som DerivedData och stora mappar, men det är Swift-kommandona som avgör cachens omfattning.

Översikt över beslut och risker

Rensa Swift Package Manager-cachen (SPM) säkert: när du ska använda swift package clean, reset eller purge-cache och hur du behåller Package.resolved intakt.

Vanliga frågor