#region Copyright & License Information /* * Copyright 2007-2020 The OpenRA Developers (see AUTHORS) * This file is part of OpenRA, which is free software. It is made * available to you under the terms of the GNU General Public License * as published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. For more * information, see COPYING. */ #endregion using System; using System.Diagnostics; using System.IO; using System.Reflection; namespace OpenRA { public enum PlatformType { Unknown, Windows, OSX, Linux } public enum SupportDirType { System, ModernUser, LegacyUser, User } public static class Platform { public const string SupportDirPrefix = "^"; public static PlatformType CurrentPlatform { get { return currentPlatform.Value; } } public static readonly Guid SessionGUID = Guid.NewGuid(); static Lazy currentPlatform = Exts.Lazy(GetCurrentPlatform); static bool supportDirInitialized; static string systemSupportPath; static string legacyUserSupportPath; static string modernUserSupportPath; static string userSupportPath; static PlatformType GetCurrentPlatform() { if (Environment.OSVersion.Platform == PlatformID.Win32NT) return PlatformType.Windows; try { var psi = new ProcessStartInfo("uname", "-s"); psi.UseShellExecute = false; psi.RedirectStandardOutput = true; var p = Process.Start(psi); var kernelName = p.StandardOutput.ReadToEnd(); if (kernelName.Contains("Darwin")) return PlatformType.OSX; return PlatformType.Linux; } catch { } return PlatformType.Unknown; } public static string RuntimeVersion { get { var mono = Type.GetType("Mono.Runtime"); if (mono == null) return ".NET CLR {0}".F(Environment.Version); var version = mono.GetMethod("GetDisplayName", BindingFlags.NonPublic | BindingFlags.Static); if (version == null) return "Mono (unknown version) CLR {0}".F(Environment.Version); return "Mono {0} CLR {1}".F(version.Invoke(null, null), Environment.Version); } } /// /// Directory containing user-specific support files (settings, maps, replays, game data, etc). /// public static string SupportDir { get { return GetSupportDir(SupportDirType.User); } } public static string GetSupportDir(SupportDirType type) { if (!supportDirInitialized) InitializeSupportDir(); switch (type) { case SupportDirType.System: return systemSupportPath; case SupportDirType.LegacyUser: return legacyUserSupportPath; case SupportDirType.ModernUser: return modernUserSupportPath; default: return userSupportPath; } } static void InitializeSupportDir() { // The preferred support dir location for Windows and Linux was changed in mid 2019 to match modern platform conventions switch (CurrentPlatform) { case PlatformType.Windows: { modernUserSupportPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "OpenRA"); legacyUserSupportPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), "OpenRA"); systemSupportPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData), "OpenRA") + Path.DirectorySeparatorChar; break; } case PlatformType.OSX: { modernUserSupportPath = legacyUserSupportPath = Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.Personal), "Library", "Application Support", "OpenRA"); systemSupportPath = "/Library/Application Support/OpenRA/"; break; } case PlatformType.Linux: { legacyUserSupportPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), ".openra"); var xdgConfigHome = Environment.GetEnvironmentVariable("XDG_CONFIG_HOME"); if (string.IsNullOrEmpty(xdgConfigHome)) xdgConfigHome = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), ".config"); modernUserSupportPath = Path.Combine(xdgConfigHome, "openra"); systemSupportPath = "/var/games/openra/"; break; } default: { modernUserSupportPath = legacyUserSupportPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Personal), ".openra"); systemSupportPath = "/var/games/openra/"; break; } } // Use a local directory in the game root if it exists (shared with the system support dir) var localSupportDir = Path.Combine(GameDir, "Support"); if (Directory.Exists(localSupportDir)) userSupportPath = systemSupportPath = localSupportDir + Path.DirectorySeparatorChar; // Use the fallback directory if it exists and the preferred one does not else if (!Directory.Exists(modernUserSupportPath) && Directory.Exists(legacyUserSupportPath)) userSupportPath = legacyUserSupportPath + Path.DirectorySeparatorChar; else userSupportPath = modernUserSupportPath + Path.DirectorySeparatorChar; supportDirInitialized = true; } /// /// Specify a custom support directory that already exists on the filesystem. /// Cannot be called after Platform.SupportDir / GetSupportDir have been accessed. /// public static void OverrideSupportDir(string path) { if (supportDirInitialized) throw new InvalidOperationException("Attempted to override user support directory after it has already been accessed."); if (!Directory.Exists(path)) throw new DirectoryNotFoundException(path); if (!path.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal) && !path.EndsWith(Path.AltDirectorySeparatorChar.ToString(), StringComparison.Ordinal)) path += Path.DirectorySeparatorChar; InitializeSupportDir(); userSupportPath = path; } public static string GameDir { get { var dir = AppDomain.CurrentDomain.BaseDirectory; // Add trailing DirectorySeparator for some buggy AppPool hosts if (!dir.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)) dir += Path.DirectorySeparatorChar; return dir; } } /// Replaces special character prefixes with full paths. public static string ResolvePath(string path) { path = path.TrimEnd(' ', '\t'); // Paths starting with ^ are relative to the support dir if (IsPathRelativeToSupportDirectory(path)) path = SupportDir + path.Substring(1); // Paths starting with . are relative to the game dir if (path == ".") return GameDir; if (path.StartsWith("./", StringComparison.Ordinal) || path.StartsWith(".\\", StringComparison.Ordinal)) path = GameDir + path.Substring(2); return path; } /// Replace special character prefixes with full paths. public static string ResolvePath(params string[] path) { return ResolvePath(Path.Combine(path)); } /// /// Replace the full path prefix with the special notation characters ^ or . /// and transforms \ path separators to / on Windows /// public static string UnresolvePath(string path) { // Use a case insensitive comparison on windows to avoid problems // with inconsistent drive letter case var compare = CurrentPlatform == PlatformType.Windows ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal; if (path.StartsWith(SupportDir, compare)) path = SupportDirPrefix + path.Substring(SupportDir.Length); if (path.StartsWith(GameDir, compare)) path = "./" + path.Substring(GameDir.Length); if (CurrentPlatform == PlatformType.Windows) path = path.Replace('\\', '/'); return path; } public static bool IsPathRelativeToSupportDirectory(string path) { return path.StartsWith(SupportDirPrefix, StringComparison.Ordinal); } } }