feat: add installPath to SetSource(), simplify OSS test code to use SetSource()

- SetSource() now accepts optional installPath parameter for scenarios
  where the current process runs from a subdirectory (e.g. OSS upgrade)
  and generalupdate.manifest.json lives in the parent directory.
- Update SetSource() XML doc to mention OssStrategy and all AppType modes.
- Update class-level example to show both standard and OSS usage patterns.
- Simplify ClientTest and UpgradeTest OSS paths to use SetSource()
  instead of SetConfig(new UpdateRequest{...}) — matching the standard
  flow pattern where only secrets are passed in code and identity
  fields are read from generalupdate.manifest.json.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: JusterZhu

src/c#/GeneralUpdate.Core/Bootstrap/GeneralUpdateBootstrap.cs

@@ -53,18 +53,33 @@ namespace GeneralUpdate.Core;
 /// components, network policies, and OS strategy.</para>
 /// </remarks>
 /// <example>
+/// <para><b>Standard flow (Client):</b></para>
 /// <code>
 /// var result = await new GeneralUpdateBootstrap()
-///     .SetConfig(new UpdateRequest {
-///         UpdateUrl = "https://api.example.com",
-///         ClientVersion = "1.0.0",
-///         InstallPath = @"C:\MyApp",
-///         AppSecretKey = "my-key"
-///     })
+///     .SetSource("https://api.example.com", "my-key")
 ///     .SetOption(Option.AppType, AppType.Client)
 ///     .Hooks&lt;MyCustomHooks&gt;()
 ///     .LaunchAsync();
 /// </code>
+/// <para><b>OSS flow (Object Storage Service):</b></para>
+/// <code>
+/// // OssClient — only secrets in code; identity from generalupdate.manifest.json
+/// var result = await new GeneralUpdateBootstrap()
+///     .SetSource("https://oss.example.com/versions.json", "my-key")
+///     .SetOption(Option.AppType, AppType.OssClient)
+///     .Hooks&lt;MyCustomHooks&gt;()
+///     .LaunchAsync();
+///
+/// // OssUpgrade — running from a subdirectory; pass installPath to locate
+/// // generalupdate.manifest.json in the parent directory
+/// var installPath = Path.GetFullPath(Path.Combine(baseDir, ".."));
+/// var result = await new GeneralUpdateBootstrap()
+///     .SetSource("https://oss.example.com/versions.json", "my-key",
+///         installPath: installPath)
+///     .SetOption(Option.AppType, AppType.OssUpgrade)
+///     .Hooks&lt;MyCustomHooks&gt;()
+///     .LaunchAsync();
+/// </code>
 /// </example>
 public class GeneralUpdateBootstrap : AbstractBootstrap<GeneralUpdateBootstrap, IStrategy>
 {
@@ -232,15 +247,29 @@ public GeneralUpdateBootstrap SetConfig(string filePath)
     /// <summary>
     ///     Zero-config entry-point: supply only secrets. Provides sensible identity defaults
     ///     that pass <see cref="UpdateRequest.Validate"/>; the real identity metadata is
-    ///     discovered later by <see cref="ClientStrategy"/> from <c>generalupdate.manifest.json</c>.
+    ///     discovered later by <see cref="ClientStrategy"/> or <see cref="OssStrategy"/>
+    ///     from <c>generalupdate.manifest.json</c>. Works with all <see cref="AppType"/>
+    ///     modes (<c>Client</c>, <c>Upgrade</c>, <c>OssClient</c>, <c>OssUpgrade</c>).
     /// </summary>
+    /// <param name="updateUrl">The remote endpoint for update validation or version config retrieval.</param>
+    /// <param name="appSecretKey">The application secret key used for authentication.</param>
+    /// <param name="reportUrl">Optional URL for reporting update status back to the server.</param>
+    /// <param name="scheme">Optional URL scheme override (e.g. <c>"https"</c>).</param>
+    /// <param name="token">Optional authentication token for API requests.</param>
+    /// <param name="installPath">
+    /// Optional override for the installation root directory. When <c>null</c>,
+    /// defaults to <see cref="AppDomain.CurrentDomain.BaseDirectory"/>. Set this when
+    /// the current process runs from a subdirectory (e.g. the OSS upgrade process in
+    /// <c>update/</c>) and <c>generalupdate.manifest.json</c> lives in the parent.
+    /// </param>
     /// <returns>This bootstrap instance for chaining.</returns>
     public GeneralUpdateBootstrap SetSource(
         string updateUrl,
         string appSecretKey,
         string? reportUrl = null,
         string? scheme = null,
-        string? token = null)
+        string? token = null,
+        string? installPath = null)
     {
         var config = new UpdateRequest
         {
@@ -250,6 +279,8 @@ public GeneralUpdateBootstrap SetSource(
             Scheme = scheme,
             ReportUrl = reportUrl
         };
+        if (installPath != null)
+            config.InstallPath = installPath;
         return SetConfig(config);
     }
 

tests/ClientTest/Program.cs

@@ -39,22 +39,18 @@ static async Task RunOssClientAsync()
     Console.WriteLine($"Started at {DateTime.Now}");
     Console.WriteLine($"Running from: {AppDomain.CurrentDomain.BaseDirectory}");
 
-    // Secrets come from code. Identity fields (MainAppName, ClientVersion,
-    // UpdateAppName, UpdatePath) are read from generalupdate.manifest.json
-    // by OssStrategy via AppMetadataDiscoverer.Discover() — same as standard flow.
+    // Only secrets are supplied in code. Identity fields (MainAppName,
+    // ClientVersion, UpdateAppName, UpdatePath) are read from
+    // generalupdate.manifest.json by OssStrategy via
+    // AppMetadataDiscoverer.Discover() — same as the standard flow.
     var updateUrl = "http://localhost:5000/packages/versions.json";
     var appSecretKey = "dfeb5833-975e-4afb-88f1-6278ee9aeff6";
 
     Console.WriteLine($"UpdateUrl: {updateUrl}");
     Console.WriteLine();
 
     await new GeneralUpdateBootstrap()
-        .SetConfig(new UpdateRequest
-        {
-            UpdateUrl = updateUrl,
-            InstallPath = AppDomain.CurrentDomain.BaseDirectory,
-            AppSecretKey = appSecretKey
-        })
+        .SetSource(updateUrl, appSecretKey)
         .SetOption(Option.AppType, AppType.OssClient)
         .Hooks<ClientTestHooks>()
         .AddListenerMultiDownloadStatistics(OnDownloadStatistics)

tests/UpgradeTest/Program.cs

@@ -44,14 +44,15 @@ static async Task RunOssUpgradeAsync()
     Console.WriteLine($"InstallPath={installPath} (parent, where manifest + versions.json live)");
     Console.WriteLine();
 
+    // Only secrets and InstallPath are supplied in code. Identity fields
+    // (MainAppName, ClientVersion, UpdateAppName) are read from
+    // generalupdate.manifest.json by OssStrategy via
+    // AppMetadataDiscoverer.Discover() — same as the standard OSS client flow.
     await new GeneralUpdateBootstrap()
-        .SetConfig(new UpdateRequest
-        {
-            UpdateUrl = "http://localhost:5000/packages/versions.json",
-            InstallPath = installPath,
-            AppSecretKey = "dfeb5833-975e-4afb-88f1-6278ee9aeff6"
-            // Identity fields from generalupdate.manifest.json via Discover().
-        })
+        .SetSource(
+            "http://localhost:5000/packages/versions.json",
+            "dfeb5833-975e-4afb-88f1-6278ee9aeff6",
+            installPath: installPath)
         .SetOption(Option.AppType, AppType.OssUpgrade)
         .Hooks<UpgradeTestHooks>()
         .AddListenerMultiDownloadStatistics(OnDownloadStatistics)