C# 開發智慧型手機推箱子遊戲 (二) - Fcl 靜態類：補足 .NET CF 缺失的 API

背景：.NET Compact Framework 的缺口

.NET CF 是 .NET Framework 的子集，為了體積精簡，移除了一些「不常用」API。但實務開發常需要這些功能，Common/Fcl.cs 即為**自行實作的補完層**。

完整實作

static class Fcl
{
    // 1. Environment.NewLine → 固定 \r\n (CF 不支援 PlatformID.Unix 判斷)
    public static string NewLine => "\r\n";

    // 2. File.ReadAllText / WriteAllText (CF 無此靜態方法)
    public static string ReadAllText(string path)
    {
        if (!File.Exists(path)) return "";
        using (var sr = new StreamReader(path, Pub.Encode))
            return sr.ReadToEnd();
    }
    public static void WriteAllText(string path, string contents)
    {
        using (var sw = new StreamWriter(path, false, Pub.Encode))
            sw.Write(contents);
    }

    // 3. Point + Size → Point (CF 缺少 Point.op_Addition)
    public static Point Add(Point pt, Size sz) => new Point(pt.X + sz.Width, pt.Y + sz.Height);

    // 4. Array.Resize (CF 2.0 缺少泛型版本)
    public static void Resize(ref T[] array, int newSize)
    {
        if (array != null && array.Length == newSize) return;
        if (array == null) array = new T[0];
        var newArr = new T[newSize];
        Array.Copy(array, newArr, Math.Min(array.Length, newSize));
        array = newArr;
    }
}

設計考量與踩坑記

實際應用範例

主視窗載入時：依平台決定是否啟用「前端顯示」

protected override void OnLoad(EventArgs e)
{
    base.OnLoad(e);
    // Windows CE 不支援 TopMost，避免遮蔽輸入法等系統 UI
    miTopMost.Enabled = (Environment.OSVersion.Platform != PlatformID.WinCE);
    env.LoadConfig();
    env.LoadGroup();
    LoadLevel(true);
    if (env.IsSave) Restore(env.Steps);
}

此處若直接用 PlatformID.Unix 判斷會編譯失敗，改用 WinCE 判斷是正解。

擴充建議

• 補足 Path.GetFileNameWithoutExtension、String.IsNullOrEmpty 等 CF 早期版本缺失的方法。
• 若專案升級目標為 .NET Standard / .NET 6+，可直接移除此類，改用標準 API。