githubmirror/Files

src/Files.App/Constants.cs
294 строки10 KB
Saravanan G
Code Quality: Improve startup error handling for Windows App Runtime (#18208)
05 мар 2026, 18:25
05 мар 2026, 18:2515add27
// Copyright (c) Files Community
// Licensed under the MIT License.

using Windows.ApplicationModel;

namespace Files.App
{
	public static class Constants
	{
		public static class AdaptiveLayout
		{
			public const float ExtraLargeThreshold = 85.0f;

			public const float LargeThreshold = 80.0f;

			public const float MediumThreshold = 60.0f;

			public const float SmallThreshold = 25.0f;

			public const float ExtraSmallThreshold = 15.0f;
		}

		// The following constants will be replaced with actual values by the Files CI workflow
		public static class AutomatedWorkflowInjectionKeys
		{

			public const string GitHubClientId = "githubclientid.secret";

			public const string BingMapsSecret = "bingmapskey.secret";

			public const string SentrySecret = "sentry.secret";
		}

		public static class KnownImageFormats
		{
			public const string BITMAP_IMAGE_FORMAT = "bitmapimage";
		}

		public static class ImageRes
		{
			// See imageres.dll for more icon indexes to add
			public const int QuickAccess = 1024;
			public const int Desktop = 183;
			public const int Downloads = 184;
			public const int Documents = 112;
			public const int Pictures = 113;
			public const int Music = 108;
			public const int Videos = 189;
			public const int GenericDiskDrive = 35;
			public const int WindowsDrive = 36;
			public const int ThisPC = 109;
			public const int Network = 25;
			public const int RecycleBin = 55;
			public const int CloudDrives = 1040;
			public const int OneDrive = 1043;
			public const int Libraries = 1023;
			public const int Folder = 3;
			public const int ShieldIcon = 78;
			public const int SearchIcon = 177;
		}

		public static class Shell32
		{
			// See shell32.dll for more icon indexes to add
			public const int QuickAccess = 51380;
		}

		public static class FluentIconsPaths
		{
			public const string CloudDriveIcon = "ms-appx:///Assets/FluentIcons/CloudDrive.png";
			public const string StarIcon = "ms-appx:///Assets/FluentIcons/Star.png";
			public const string FileTagsIcon = "ms-appx:///Assets/FluentIcons/FileTags.png";
			public const string HomeIcon = "ms-appx:///Assets/FluentIcons/Home.png";
		}

		public static class WslIconsPaths
		{
			public const string Alpine = "ms-appx:///Assets/WSL/alpinepng.png";
			public const string DebianIcon = "ms-appx:///Assets/WSL/debianpng.png";
			public const string GenericIcon = "ms-appx:///Assets/WSL/genericpng.png";
			public const string KaliIcon = "ms-appx:///Assets/WSL/kalipng.png";
			public const string OpenSuse = "ms-appx:///Assets/WSL/opensusepng.png";
			public const string UbuntuIcon = "ms-appx:///Assets/WSL/ubuntupng.png";
		}

		public static class AssetPaths
		{
			public const string DevLogo = "Assets/AppTiles/Dev/Logo.ico";
			public const string PreviewLogo = "Assets/AppTiles/Preview/Logo.ico";
			public const string StableLogo = "Assets/AppTiles/Release/Logo.ico";
		}

		public static class UI
		{
			public const float DimItemOpacity = 0.4f;

			/// <summary>
			/// The minimum width of the sidebar in expanded state
			/// </summary>
			public const double MinimumSidebarWidth = 180;

			public const double MaximumSidebarWidth = 500;

			// For contextmenu hacks, must match WinUI style
			public const double ContextMenuMaxHeight = 480;

			// For contextmenu hacks, must match WinUI style
			public const double ContextMenuSecondaryItemsHeight = 32;

			// For contextmenu hacks, must match WinUI style
			public const double ContextMenuPrimaryItemsHeight = 48;

			// For contextmenu hacks
			public const double ContextMenuLabelMargin = 10;

			// For contextmenu hacks
			public const double ContextMenuItemsMaxWidth = 250;

			public const double MultiplePaneWidthThreshold = 750;
		}

		public static class Appearance
		{
			public const string StandardFont = "Segoe UI Variable";
		}

		// Default icon sizes that are available for files and folders
		public static class ShellIconSizes
		{
			public const int Small = 16;

			public const int Large = 32;

			public const int ExtraLarge = 48;

			public const int Jumbo = 256;
		}

		public static class Widgets
		{
			public static class Drives
			{
				public const float LowStorageSpacePercentageThreshold = 90.0f;
			}
		}

		public static class LocalSettings
		{
			public const string DateTimeFormat = "datetimeformat";

			public const string SettingsFolderName = "settings";

			public const string UserSettingsFileName = "user_settings.json";

			public const string FileTagSettingsFileName = "filetags.json";

			public const string UserSettingsDatabaseFileName = "user_settings.db";

			public const string FileTagSettingsDatabaseFileName = "filetags.db";
		}

		public static class PreviewPane
		{
			/// <summary>
			/// The maximum number of characters that should be loaded into the preview.
			/// Enforcing this limit ensures that attempting to open an absurdly large file will not cause Files to freeze.
			/// </summary>
			public const int TextCharacterLimit = 10000;

			/// <summary>
			/// The maximum number of pages loaded into the PDF preview.
			/// </summary>
			public const int PDFPageLimit = 10;

			/// <summary>
			/// The maximum file size, in bytes, that will attempted to be loaded as text if the extension is unknown.
			/// </summary>
			public const long TryLoadAsTextSizeLimit = 500000;
		}

		public static class ResourceFilePaths
		{
			/// <summary>
			/// The path to the json file containing a list of file properties to be loaded in the properties window details page.
			/// </summary>
			public const string DetailsPagePropertiesJsonPath = @"ms-appx:///Assets/Resources/PropertiesInformation.json";

			/// <summary>
			/// The path to the json file containing a list of file properties to be loaded in the preview pane.
			/// </summary>
			public const string PreviewPaneDetailsPropertiesJsonPath = @"ms-appx:///Assets/Resources/PreviewPanePropertiesInformation.json";
		}

		public static class Filesystem
		{
			public const int ExtendedAsciiCodePage = 437;

			public const string CachedEmptyItemName = "fileicon_cache";
		}

		public static class ExternalUrl
		{
			public const string GitHubRepoUrl = @"https://github.com/files-community/Files";
			public const string DocumentationUrl = @"https://files.community/docs";
			public const string DiscordUrl = @"https://discord.gg/files";
			public const string FeatureRequestUrl = @"https://github.com/files-community/Files/issues/new?labels=feature+request&template=feature_request.yml";
			public const string BugReportUrl = @"https://github.com/files-community/Files/issues/new?labels=bug&template=bug_report.yml";
			public const string PrivacyPolicyUrl = @"https://files.community/privacy";
			public const string SupportUsUrl = @"https://github.com/files-community/Files?sponsor";
			public const string CrowdinUrl = @"https://crowdin.com/project/files-app";
			public static readonly string ReleaseNotesUrl = $"https://files.community/blog/posts/v{Package.Current.Id.Version.Major}-{Package.Current.Id.Version.Minor}-{Package.Current.Id.Version.Build}?minimal";
		}

		public static class DocsPath
		{
			public const string ThirdPartyNoticePath = @"ms-appx:///NOTICE.md";
		}

		public static class Actions
		{
			public const int MaxSelectedItems = 5;
		}

		public static class DragAndDrop
		{
			public const Int32 HoverToOpenTimespan = 1300;
		}

		public static class UserEnvironmentPaths
		{
			public static readonly string DesktopPath = Windows.Storage.UserDataPaths.GetDefault().Desktop;

			public static readonly string DownloadsPath = Windows.Storage.UserDataPaths.GetDefault().Downloads;

			public static readonly string LocalAppDataPath = Windows.Storage.UserDataPaths.GetDefault().LocalAppData;

			// Currently is the command to open the folder from cmd ("cmd /c start Shell:RecycleBinFolder")
			public const string RecycleBinPath = @"Shell:RecycleBinFolder";

			public const string NetworkFolderPath = @"Shell:NetworkPlacesFolder";

			public const string MyComputerPath = @"Shell:MyComputerFolder";

			public static readonly string TempPath = Environment.GetEnvironmentVariable("TEMP") ?? "";

			public static readonly string HomePath = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);

			public static readonly string SystemRootPath = Environment.GetFolderPath(Environment.SpecialFolder.Windows);

			public static readonly string RecentItemsPath = Environment.GetFolderPath(Environment.SpecialFolder.Recent);

			public static readonly string SystemDrivePath;

			static UserEnvironmentPaths()
			{
				var systemDrive = Environment.GetEnvironmentVariable("SystemDrive");
				SystemDrivePath = !string.IsNullOrEmpty(systemDrive) ? systemDrive : "C:";
			}

			public static Dictionary<string, string> ShellPlaces =
				new()
				{
					{ "::{645FF040-5081-101B-9F08-00AA002F954E}", RecycleBinPath },
					{ "::{5E5F29CE-E0A8-49D3-AF32-7A7BDC173478}", "Home" /*MyComputerPath*/ },
					{ "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}", MyComputerPath },
					{ "::{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}", NetworkFolderPath },
					{ "::{208D2C60-3AEA-1069-A2D7-08002B30309D}", NetworkFolderPath },
					{ RecycleBinPath.ToUpperInvariant(), RecycleBinPath },
					{ MyComputerPath.ToUpperInvariant(), MyComputerPath },
					{ NetworkFolderPath.ToUpperInvariant(), NetworkFolderPath },
				};
		}

		public static class Distributions
		{
			public static readonly string[] KnownAppNames =
			{
				"49306atecsolution.FilesUWP", // store stable
				"FilesStable", // sideload stable
				"FilesPreview", // sideload preview
				"49306atecsolution.FilesPreview", // store preview
				"FilesDev", // dev
			};
		}

		public static class Startup
		{
			// These strings are intentionally hardcoded and cannot be moved to resource files.
			// The Windows App Runtime (which powers the resource loading system) may itself be unavailable at this point
			public const string MissingRuntimeMessage = "Files failed to start. A required Windows component could not be loaded. Try reinstalling Files from the Microsoft Store or from https://files.community/download";
			public const string MissingRuntimeTitle = "Files - Startup Error";
		}
	}
}