ExtractFiles@1 - Dosyaları ayıklama v1 görevi

.7z, .rar, .tar.gz ve .zip gibi çeşitli arşiv ve sıkıştırma dosyalarını ayıklamak için bu görevi kullanın.

Syntax

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Girişler

archiveFilePatterns - Arşiv dosyası desenleri
string. Gereklidir. Varsayılan değer: **/*.zip.

Ayıklanması gereken arşiv dosyalarının dosya yollarını veya desenlerini belirtir. Birden çok minimatch deseni çizgisini destekler. Dosyaları Ayıkla görevi hakkında daha fazla bilgi edinin.

Ayıklamak istediğiniz arşivlerle eşleşecek desenleri belirtir. Varsayılan olarak, desenler deponun kök klasöründe başlar (belirttiğiniz $(Build.SourcesDirectory)gibi).
Ayıklanan arşivlerle eşleşen her satırda bir tane olan desen filtrelerini belirtir. Örneğin:

• test.zip kök klasöründeki test.zip dosyasını ayıklar.
• test/*.zip test klasöründeki tüm .zip dosyalarını ayıklar.
• **/*.tar kök klasördeki ve alt klasörlerdeki tüm .tar dosyalarını ayıklar.
• **/bin/*.7z "bin" adlı herhangi bir alt klasördeki tüm .7z dosyalarını ayıklar.
  Desen, ayıklanacak arşiv içeriklerini değil, yalnızca arşiv dosyası yollarını eşleştirmek için kullanılır. Bu nedenle, yerine **/bingibi **/bin/** desenler belirtmeniz gerekir.

destinationFolder - Hedef klasör
string. Gereklidir.

Arşiv dosyalarının ayıklanması gereken hedef klasörü belirtir. Depoda dosyalar yoksa değişkenleri kullanın. Örneğin: $(agent.builddirectory).

cleanDestinationFolder - Ayıklamadan önce hedef klasörü temizleme
boolean. Varsayılan değer: true.

Arşiv içeriği ayıklanmasından önce hedef dizini temizleme seçeneğini belirtir.

overwriteExistingFiles - Varolan dosyaların üzerine yazma
boolean. Varsayılan değer: false.

Zaten varsa hedef dizindeki mevcut dosyaların üzerine yazma seçeneğini belirtir. seçeneği ise false, betik mevcut dosyalara sorar ve üzerine yazmak isteyip istemediğinizi sorar.

pathToSevenZipTool - 7z yardımcı programının yolu
string.

7z yardımcı programının özel yolunu belirtir. Örneğin, C:\7z\7z.exe Windows'da ve /usr/local/bin/7z MacOS/Ubuntu'da. Windows'ta belirtilmezse, bir görevle birlikte sağlanan varsayılan 7zip sürümü kullanılır.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Eşleştirme desenlerini kullanarak arşivlerdeki dosyaları hedef klasöre ayıklamak için bu görevi kullanın. .zip, .jar, .war, .ear, .tar, .7z ve daha fazlası dahil olmak üzere bir dizi standart arşiv biçimi desteklenir.

Dosya eşleştirme desenleri hakkında daha fazla bilgi için bkz. Dosya eşleştirme desenleri başvurusu.

Örnekler

Tüm .zip dosyalarını yinelemeli olarak ayıklama

Bu örnek, kök dosyalar ve alt klasörlerdeki dosyalar da dahil olmak üzere tüm .zip dosyalarını özyinelemeli olarak ayıklar.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Alt klasörden tüm .zip dosyalarını ayıklama

Bu örnekte ve ayıklanırtest/one.zip, ancak bırakılacaktırtest/nested/three.zip.test/two.zip

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Bu görev aşağıdaki komut kısıtlamaları kullanılarak çalıştırılır: kısıtlı
Ayarlanabilir değişkenler	Bu görevin şu değişkenleri ayarlama izni var: Değişkenleri ayarlama devre dışı bırakıldı
Aracı sürümü	2.182.1 veya üzeri
Görev kategorisi	Yardımcı Program

Ayrıca bkz.

• Dosya eşleştirme desenleri başvurusu