Merge branch 'main' of https://github.com/files-community/Files into terminal

Author: gave92

.github/README.md

@@ -1,46 +1,48 @@
 <p align="center">
-  <img alt="Files Logo" src="../src/Files.App%20(Package)/Assets/AppTiles/Release/StoreLogo.scale-400.png" width="100px" />
-  <h1 align="center">Files</h1>
+  <img alt="Files hero image" src="../assets/ReadmeHero.png" />
 </p>
 
-[![Build Status](https://dev.azure.com/filescommunity/Files/_apis/build/status/Build%20Pipeline?branchName=main)](https://dev.azure.com/filescommunity/Files/_build/latest?definitionId=4&branchName=main)
-[![Crowdin](https://badges.crowdin.net/files-app/localized.svg)](https://crowdin.com/project/files-app)
-[![Discord](https://discordapp.com/api/guilds/725513575971684472/widget.png)](https://discord.gg/files)
-[![Download](https://img.shields.io/badge/Download%20Installer-blue.svg?style=flat-round)](https://files.community/download)
-[![Documentation](https://img.shields.io/badge/View%20Documentation-purple.svg?style=flat-round)](https://files.community/docs)
-
-Introducing Files, the ultimate file manager app for Windows. With its sleek and intuitive design, navigating through your files has never been easier. Files features tabs for easy switching between different folders, a column view for quick file browsing, and dual pane support for efficient file management. In addition, you can easily create and extract archives with just a few clicks, making file compression and decompression a breeze.
+<p align="center">
+  <a style="text-decoration:none" href="https://files.community/">
+    <img src="https://img.shields.io/badge/Files-Website-F9B81F" alt="Files Website" /></a>
+  <a style="text-decoration:none" href="https://github.com/files-community/Files/actions/workflows/ci.yml">
+    <img src="https://github.com/files-community/Files/actions/workflows/ci.yml/badge.svg" alt="Files CI Status" /></a>
+  <a style="text-decoration:none" href="https://crowdin.com/project/files-app">
+    <img src="https://badges.crowdin.net/files-app/localized.svg" alt="Files Localization Status" /></a>
+  <a style="text-decoration:none" href="https://discord.gg/files">
+    <img src="https://img.shields.io/discord/725513575971684472?label=Discord&color=7289da" alt="Files Discord" /></a>
+</p>
 
-Files also offers advanced features such as file tagging for easy organization, support for QuickLook for previewing files without opening them, and the ability to customize the background color to match your personal style. Whether you're a power user or just looking for a better way to manage your files, Files has everything you need to keep your files organized and easily accessible. With its combination of powerful features and ease of use, Files is the ultimate file management solution for Windows.
+Files is a modern file manager that helps users organize their files and folders. Our mission with Files is to build the best file manager for Windows, and we’re proud to be building it out in the open so everyone can participate. User feedback helps shape the features we work on, & the bug reports on GitHub help to make Files more reliable. Built and maintained by the open-source community, Files features robust multitasking experiences, file tags, deep integrations, and an intuitive design.
 
-## Building from source
+## Installing and running Files
 
-### 1. Prerequisites
+Files is a community-driven project that depends on your support to grow and improve. Please consider purchasing Files through the Microsoft Store or supporting us on GitHub if you use the classic installer.
 
-- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) with the following individual components:
-    - Windows 11 SDK (10.0.22621.0)
-    - .NET 8 SDK
-    - MSVC v143 - VS 2022 C++ x64/x86 or ARM64 build tools (latest)
-    - C++ ATL for latest v143 build tools (x86 & x64 or ARM64)
-    - Git for Windows
-- [Windows App SDK 1.5](https://learn.microsoft.com/windows/apps/windows-app-sdk/downloads#current-releases)
-    
-### 2. Clone the repository
+You can also use the preview version alongside the stable release to get early access to new features and improvements.
 
-```ps
-git clone https://github.com/files-community/Files
-```
-
-This will create a local copy of the repository.
+<p align="left">
+  <!-- Store Badge -->
+  <a style="text-decoration:none" href="https://apps.microsoft.com/detail/9NGHP3DX8HDX?launch=true&mode=full">
+    <picture>
+      <source media="(prefers-color-scheme: light)" srcset="../assets/StoreBadge-dark.png" width="220" />
+      <img src="../assets/StoreBadge-light.png" width="220" />
+  </picture></a>
+  &ensp;
+  <!-- Classic Installer Badge -->
+  <a style="text-decoration:none" href="https://cdn.files.community/files/download/Files.Stable.exe">
+    <picture>
+      <source media="(prefers-color-scheme: light)" srcset="../assets/ClassicInstallerBadge-dark.png" width="220" />
+      <img src="../assets/ClassicInstallerBadge-light.png" width="220" />
+    </picture></a>
+</p>
 
-### 3. Build the project
+## Building from source
 
-To build Files for development, open the `Files.sln` item in Visual Studio. Right-click on the `Files.Package` packaging project in solution explorer and select ‘Set as Startup item’.
+Instructions for building the source code can be found on our [documentation site](https://files.community/docs/contributing/building-from-source).
 
-In the top pane, select the items which correspond to your desired build mode and the processor architecture of your device like below:
-![image](https://user-images.githubusercontent.com/39923744/148721296-2bd132d0-4a4d-4555-8f58-16b00b18ade3.png)
 
-## Contributors
+## Contributing to Files
 
 Want to contribute to this project? Let us know with an [issue](https://github.com/files-community/Files/issues) that communicates your intent to create a [pull request](https://github.com/files-community/Files/pulls). Also, view our [contributing guidelines](https://github.com/files-community/Files/blob/main/.github/CONTRIBUTING.md) to make sure you're up to date on the coding conventions.
 

.github/workflows/cd-preview.yml

@@ -1,6 +1,16 @@
 # Copyright (c) 2024 Files Community
 # Licensed under the MIT License. See the LICENSE.
 
+# Abstract:
+#  Deploys Files Preview (Sideload).
+#
+# Workflow:
+#  1. Configure manifest, logo and secrets
+#  2. Restore, build and package Files
+#  3. Publish the appinstaller to files.community
+#  4. Sign the package
+#  5. Publish the package to Azure
+
 name: Files CD (Preview)
 
 on:
@@ -16,35 +26,37 @@ jobs:
         configuration: [Preview]
         platform: [x64]
     env:
-      SOLUTION_NAME: 'Files.sln'
-      PACKAGE_PROJECT_DIR: 'src\Files.App (Package)'
-      PACKAGE_PROJECT_PATH: 'src\Files.App (Package)\Files.Package.wapproj'
-      TEST_PROJECT_PATH: 'tests\Files.InteractionTests\Files.InteractionTests.csproj'
-      CONFIGURATION: ${{ matrix.configuration }}
-      PLATFORM: ${{ matrix.platform }}
-      APPX_BUNDLE_PLATFORMS: 'x64|arm64'
-      WORKING_DIR: ${{ github.workspace }} # Default: D:\a\Files\Files\
-      ARTIFACTS_STAGING_DIR:  ${{ github.workspace }}\artifacts
-      APPX_PACKAGE_DIR: ${{ github.workspace }}\artifacts\AppxPackages
+      SOLUTION_NAME:              'Files.sln'
+      CONFIGURATION:              '${{ matrix.configuration }}'
+      PLATFORM:                   '${{ matrix.platform }}'
+      APPX_BUNDLE_PLATFORMS:      'x64|arm64'
+      WORKING_DIR:                '${{ github.workspace }}' # D:\a\Files\Files\
+      ARTIFACTS_STAGING_DIR:      '${{ github.workspace }}\artifacts'
+      APPX_PACKAGE_DIR:           '${{ github.workspace }}\artifacts\AppxPackages'
+      PACKAGE_PROJECT_DIR:        'src\Files.App (Package)'
+      PACKAGE_PROJECT_PATH:       'src\Files.App (Package)\Files.Package.wapproj'
+      PACKAGE_MANIFEST_PATH:      'src\Files.App (Package)\Package.appxmanifest'
+      TEST_PROJECT_PATH:          'tests\Files.InteractionTests\Files.InteractionTests.csproj'
+      APP_INSTALLER_SIDELOAD_URL: 'https://cdn.files.community/files/preview/'
 
     steps:
     - name: Checkout the repository
       uses: actions/checkout@v4
     - name: Setup MSBuild
-      uses: microsoft/setup-msbuild@v1
+      uses: microsoft/setup-msbuild@v2
     - name: Setup NuGet
-      uses: NuGet/setup-nuget@v1.1.1
+      uses: NuGet/setup-nuget@v2
     - name: Setup .NET 8
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: '8.0.x'
 
-    - name: Configure the package manifest, logo sets, and secrets
+    - name: Configure the package manifest, logo, and secrets
       shell: pwsh
       run: |
         . './scripts/Configure-AppxManifest.ps1' `
           -Branch "$env:CONFIGURATION" `
-          -PackageProjectDir "$env:PACKAGE_PROJECT_DIR" `
+          -PackageManifestPath "$env:PACKAGE_MANIFEST_PATH" `
           -Publisher "$env:SIDELOAD_PUBLISHER_SECRET" `
           -WorkingDir "$env:WORKING_DIR" `
           -SecretBingMapsKey "$env:SECRET_BINGMAPS_KEY" `
@@ -65,7 +77,7 @@ jobs:
       shell: pwsh
       run: 'nuget restore $env:SOLUTION_NAME'
 
-    - name: Restore ${{ env.SOLUTION_NAME  }}
+    - name: Restore Files
       shell: pwsh
       run: |
         msbuild $env:SOLUTION_NAME `
@@ -74,7 +86,7 @@ jobs:
         -p:Configuration=$env:CONFIGURATION `
         -p:PublishReadyToRun=true
 
-    - name: Build ${{ env.SOLUTION_NAME }}
+    - name: Build & package Files
       shell: pwsh
       run: |
         msbuild "$env:PACKAGE_PROJECT_PATH" `
@@ -87,7 +99,7 @@ jobs:
         -p:AppxBundle=Always `
         -p:UapAppxPackageBuildMode=Sideload `
         -p:GenerateAppInstallerFile=True `
-        -p:AppInstallerUri=https://cdn.files.community/files/preview/
+        -p:AppInstallerUri=$env:APP_INSTALLER_SIDELOAD_URL
 
     - name: Remove empty files from the packages
       shell: bash
@@ -101,8 +113,8 @@ jobs:
         $fileContent = $fileContent.Replace("http://schemas.microsoft.com/appx/appinstaller/2017/2", $newSchema)
         $fileContent | Set-Content $localFilePath
 
-    - name: Sign files with Azure Trusted Signing
-      uses: azure/[email protected].16
+    - name: Sign Files with Azure Trusted Signing
+      uses: azure/[email protected].20
       with:
         azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
         azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
@@ -119,12 +131,12 @@ jobs:
         timestamp-digest: SHA256
 
     - name: Login to Azure
-      uses: azure/login@v1
+      uses: azure/login@v2
       with:
         creds: ${{ secrets.AZURE_CREDENTIALS }}
 
     - name: Upload to Azure blob storage
-      uses: azure/powershell@v1
+      uses: azure/powershell@v2
       with:
         inlineScript: |
           az storage blob upload-batch --account-name "filescommunity" --destination "files" --destination-path "preview" --source ${{ env.APPX_PACKAGE_DIR }} --overwrite true
@@ -134,7 +146,7 @@ jobs:
       run: 'az logout'
 
     - name: Upload the packages to GitHub Actions
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: 'Appx Packages (${{ env.CONFIGURATION }}, ${{ env.PLATFORM }})'
         path: ${{ env.ARTIFACTS_STAGING_DIR }}

.github/workflows/cd-stable.yml

@@ -1,6 +1,16 @@
 # Copyright (c) 2024 Files Community
 # Licensed under the MIT License. See the LICENSE.
 
+# Abstract:
+#  Deploys Files (Sideload).
+#
+# Workflow:
+#  1. Configure manifest, logo and secrets
+#  2. Restore, build and package Files
+#  3. Publish the appinstaller to files.community
+#  4. Sign the package
+#  5. Publish the package to Azure
+
 name: Files CD (Stable)
 
 on:
@@ -16,35 +26,37 @@ jobs:
         configuration: [Stable]
         platform: [x64]
     env:
-      SOLUTION_NAME: 'Files.sln'
-      PACKAGE_PROJECT_DIR: 'src\Files.App (Package)'
-      PACKAGE_PROJECT_PATH: 'src\Files.App (Package)\Files.Package.wapproj'
-      TEST_PROJECT_PATH: 'tests\Files.InteractionTests\Files.InteractionTests.csproj'
-      CONFIGURATION: ${{ matrix.configuration }}
-      PLATFORM: ${{ matrix.platform }}
-      APPX_BUNDLE_PLATFORMS: 'x64|arm64'
-      WORKING_DIR: ${{ github.workspace }} # Default: D:\a\Files\Files\
-      ARTIFACTS_STAGING_DIR:  ${{ github.workspace }}\artifacts
-      APPX_PACKAGE_DIR: ${{ github.workspace }}\artifacts\AppxPackages
+      SOLUTION_NAME:              'Files.sln'
+      CONFIGURATION:              '${{ matrix.configuration }}'
+      PLATFORM:                   '${{ matrix.platform }}'
+      APPX_BUNDLE_PLATFORMS:      'x64|arm64'
+      WORKING_DIR:                '${{ github.workspace }}' # D:\a\Files\Files\
+      ARTIFACTS_STAGING_DIR:      '${{ github.workspace }}\artifacts'
+      APPX_PACKAGE_DIR:           '${{ github.workspace }}\artifacts\AppxPackages'
+      PACKAGE_PROJECT_DIR:        'src\Files.App (Package)'
+      PACKAGE_PROJECT_PATH:       'src\Files.App (Package)\Files.Package.wapproj'
+      PACKAGE_MANIFEST_PATH:      'src\Files.App (Package)\Package.appxmanifest'
+      TEST_PROJECT_PATH:          'tests\Files.InteractionTests\Files.InteractionTests.csproj'
+      APP_INSTALLER_SIDELOAD_URL: 'https://cdn.files.community/files/stable/'
 
     steps:
     - name: Checkout the repository
       uses: actions/checkout@v4
     - name: Setup MSBuild
-      uses: microsoft/setup-msbuild@v1
+      uses: microsoft/setup-msbuild@v2
     - name: Setup NuGet
-      uses: NuGet/setup-nuget@v1.1.1
+      uses: NuGet/setup-nuget@v2
     - name: Setup .NET 8
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: '8.0.x'
 
-    - name: Configure the package manifest, logo sets, and secrets
+    - name: Configure the package manifest, logo, and secrets
       shell: pwsh
       run: |
         . './scripts/Configure-AppxManifest.ps1' `
           -Branch "$env:CONFIGURATION" `
-          -PackageProjectDir "$env:PACKAGE_PROJECT_DIR" `
+          -PackageManifestPath "$env:PACKAGE_MANIFEST_PATH" `
           -Publisher "$env:SIDELOAD_PUBLISHER_SECRET" `
           -WorkingDir "$env:WORKING_DIR" `
           -SecretBingMapsKey "$env:SECRET_BINGMAPS_KEY" `
@@ -65,7 +77,7 @@ jobs:
       shell: pwsh
       run: 'nuget restore $env:SOLUTION_NAME'
 
-    - name: Restore ${{ env.SOLUTION_NAME  }}
+    - name: Restore Files
       shell: pwsh
       run: |
         msbuild $env:SOLUTION_NAME `
@@ -74,7 +86,7 @@ jobs:
         -p:Configuration=$env:CONFIGURATION `
         -p:PublishReadyToRun=true
 
-    - name: Build ${{ env.SOLUTION_NAME }}
+    - name: Build & package Files
       shell: pwsh
       run: |
         msbuild "$env:PACKAGE_PROJECT_PATH" `
@@ -87,7 +99,7 @@ jobs:
         -p:AppxBundle=Always `
         -p:UapAppxPackageBuildMode=Sideload `
         -p:GenerateAppInstallerFile=True `
-        -p:AppInstallerUri=https://cdn.files.community/files/stable/
+        -p:AppInstallerUri=$env:APP_INSTALLER_SIDELOAD_URL
 
     - name: Remove empty files from the packages
       shell: bash
@@ -101,8 +113,8 @@ jobs:
         $fileContent = $fileContent.Replace("http://schemas.microsoft.com/appx/appinstaller/2017/2", $newSchema)
         $fileContent | Set-Content $localFilePath
 
-    - name: Sign files with Azure Trusted Signing
-      uses: azure/[email protected].16
+    - name: Sign Files with Azure Trusted Signing
+      uses: azure/[email protected].20
       with:
         azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
         azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
@@ -119,22 +131,22 @@ jobs:
         timestamp-digest: SHA256
 
     - name: Login to Azure
-      uses: azure/login@v1
+      uses: azure/login@v2
       with:
-          creds: ${{ secrets.AZURE_CREDENTIALS }}
+        creds: ${{ secrets.AZURE_CREDENTIALS }}
 
     - name: Upload to Azure blob storage
-      uses: azure/powershell@v1
+      uses: azure/powershell@v2
       with:
         inlineScript: |
-         az storage blob upload-batch --account-name "filescommunity" --destination "files" --destination-path "stable" --source ${{ env.APPX_PACKAGE_DIR }} --overwrite true
+          az storage blob upload-batch --account-name "filescommunity" --destination "files" --destination-path "stable" --source ${{ env.APPX_PACKAGE_DIR }} --overwrite true
         azPSVersion: "latest"
 
     - name: Logout from Azure
       run: 'az logout'
 
     - name: Upload the packages to GitHub Actions
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: 'Appx Packages (${{ env.CONFIGURATION }}, ${{ env.PLATFORM }})'
         path: ${{ env.ARTIFACTS_STAGING_DIR }}

.github/workflows/ci.yml

@@ -99,16 +99,13 @@ jobs:
     steps:
 
     - name: Checkout the repository
-      uses: actions/checkout@v3
-
+      uses: actions/checkout@v4
     - name: Setup MSBuild
-      uses: microsoft/setup-msbuild@v1
-
+      uses: microsoft/setup-msbuild@v2
     - name: Setup NuGet
-      uses: NuGet/[email protected]
-
+      uses: NuGet/setup-nuget@v2
     - name: Setup .NET 8
-      uses: actions/setup-dotnet@v3
+      uses: actions/setup-dotnet@v4
       with:
         dotnet-version: '8.0.x'
 
@@ -178,7 +175,7 @@ jobs:
 
     - if: env.ARCHITECTURE == env.AUTOMATED_TESTS_ARCHITECTURE && env.CONFIGURATION == env.AUTOMATED_TESTS_CONFIGURATION
       name: Upload the packages to the Artifacts
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: 'Appx Packages (${{ env.CONFIGURATION }}, ${{ env.ARCHITECTURE }})'
         path: ${{ env.ARTIFACTS_STAGING_DIR }}
@@ -207,10 +204,10 @@ jobs:
       run: exit 1
 
     - name: Checkout the repository
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Download the packages from the Artifacts
-      uses: actions/download-artifact@v3
+      uses: actions/download-artifact@v4
       with:
         name: 'Appx Packages (${{ env.CONFIGURATION }}, ${{ env.AUTOMATED_TESTS_ARCHITECTURE }})'
         path: ${{ env.ARTIFACTS_STAGING_DIR }}