AddonManager.h

Go to the documentation of this file.

#pragma once
 
#if EDITOR
 
#include "../ProjectSelect/TemplateData.h"
#include <string>
#include <vector>
 
class AddonManager
{
public:
    static void Create();
    static void Destroy();
    static AddonManager* Get();
 
    std::string GetAddonCacheDirectory();
 
    std::string GetSettingsPath();
 
    std::string GetInstalledAddonsPath();
 
    // Repository management
    void LoadSettings();
    void SaveSettings();
    void AddRepository(const std::string& url);
    void RemoveRepository(const std::string& url);
    const std::vector<AddonRepository>& GetRepositories() const { return mRepositories; }
 
    // Addon discovery
    void RefreshAllRepositories();
    void RefreshRepository(const std::string& url);
    const std::vector<Addon>& GetAvailableAddons() const { return mAvailableAddons; }
    const std::vector<AddonCategory>& GetCategories() const { return mCategories; }
 
    // Installation
    bool DownloadAddon(const Addon& addon, std::string& outError);
    bool InstallAddon(const std::string& addonCachePath, const std::string& addonId, std::string& outError);
    bool UninstallAddon(const std::string& addonId);
 
    // Fetch an addon from an arbitrary URL (GitHub repo or direct .zip), unzip it,
    // and install into the current project's Packages/. Used by the dependency resolver.
    bool DownloadAndInstallFromUrl(const std::string& addonId,
                                   const std::string& url,
                                   const std::string& ref,
                                   std::string& outError);
 
    // Auto-resolve declared dependencies on install / project load.
    bool GetAutoResolveDependencies() const { return mAutoResolveDeps; }
    void SetAutoResolveDependencies(bool v) { mAutoResolveDeps = v; SaveSettings(); }
 
    // Tracking
    void LoadInstalledAddons();
    void SaveInstalledAddons();
    const std::vector<InstalledAddon>& GetInstalledAddons() const { return mInstalledAddons; }
    std::vector<InstalledAddon>& GetInstalledAddonsMutable() { return mInstalledAddons; }
    bool IsAddonInstalled(const std::string& addonId) const;
    bool HasUpdate(const std::string& addonId) const;
    std::string GetInstalledVersion(const std::string& addonId) const;
    bool SetInstalledAddonNativeMode(const std::string& addonId, NativeAddonResolveMode mode);
    bool SyncNativeAddonBinary(const std::string& addonId, std::string& outError);
 
    // Find addon by ID
    const Addon* FindAddon(const std::string& addonId) const;
 
private:
    static AddonManager* sInstance;
    AddonManager();
    ~AddonManager();
 
    void EnsureCacheDirectory();
 
    bool FetchManifest(const std::string& url, const std::string& branch, bool& outFound);
 
    bool FetchRepositoryManifest(const std::string& url, AddonRepository& outRepo, const std::string& branch);
    bool FetchAddonMetadata(const std::string& repoUrl, const std::string& addonId, Addon& outAddon, const std::string& branch);
 
    bool MergeAddonIntoProject(const std::string& addonPath, std::string& outError);
 
    bool DownloadFile(const std::string& url, const std::string& destPath, std::string& outError);
 
    bool ExtractZip(const std::string& zipPath, const std::string& destDir, std::string& outError);
 
    std::string NormalizePath(const std::string& in);
 
    std::string ConvertToRawUrl(const std::string& gitHubUrl, const std::string& filePath, const std::string& branch);
 
    std::string ConvertToDownloadUrl(const std::string& gitHubUrl, const std::string& branch);
 
    std::string GetCurrentTimestamp();
 
    std::vector<AddonRepository> mRepositories;
    std::vector<Addon> mAvailableAddons;
    std::vector<AddonCategory> mCategories;  // Registry categories from manifest.json
    std::vector<InstalledAddon> mInstalledAddons;
    bool mAutoResolveDeps = true;
};
 
#endif