WasmEdge Module 介紹

#include <iostream>
#include <wasmedge/wasmedge.h>

int main() {
  // 1. 建立環境配置與 VM 容器
  WasmEdge_ConfigureContext *ConfCxt = WasmEdge_ConfigureCreate();
  WasmEdge_VMContext *VMCxt = WasmEdge_VMCreate(ConfCxt, NULL);

  std::cout << "[Step 1] Registering 'provider' module..." << std::endl;
  // 這裡會將 provider.wasm 載入、實例化並註冊到 Store 裡，名稱叫做 "provider"
  WasmEdge_String ProviderName = WasmEdge_StringCreateByCString("provider"); // Wasm 自己的字串類型
  WasmEdge_Result Res1 =
      WasmEdge_VMRegisterModuleFromFile(VMCxt, ProviderName, "provider.wasm");

  if (!WasmEdge_ResultOK(Res1)) {
    std::cerr << "Registration failed: " << WasmEdge_ResultGetMessage(Res1)
              << std::endl;
    return 1;
  }

  std::cout << "[Step 2] Running 'consumer.wasm'..." << std::endl;
  // 執行時，它會自動去 Store 找名為 "provider" 的模組
  WasmEdge_String FuncName = WasmEdge_StringCreateByCString("run");
  WasmEdge_Value Params[2] = {WasmEdge_ValueGenI32(10),
                              WasmEdge_ValueGenI32(20)};
  WasmEdge_Value Returns[1];

  WasmEdge_Result Res2 = WasmEdge_VMRunWasmFromFile(
      VMCxt, "consumer.wasm", FuncName, Params, 2, Returns, 1);

  if (WasmEdge_ResultOK(Res2)) {
    std::cout << ">>> Execution Result: " << WasmEdge_ValueGetI32(Returns[0])
              << " <<<" << std::endl;
  } else {
    std::cerr << "Execution failed: " << WasmEdge_ResultGetMessage(Res2)
              << std::endl;
  }

  // 清理資源
  WasmEdge_StringDelete(ProviderName);
  WasmEdge_StringDelete(FuncName);
  WasmEdge_VMDelete(VMCxt);
  WasmEdge_ConfigureDelete(ConfCxt);

  return 0;
}

#include <iostream>
#include <wasmedge/wasmedge.h>

int main() {
  // 1. 環境初始化
  WasmEdge_ConfigureContext *Conf = WasmEdge_ConfigureCreate();
  WasmEdge_StoreContext *Store = WasmEdge_StoreCreate();
  WasmEdge_ExecutorContext *Exec = WasmEdge_ExecutorCreate(Conf, NULL);
  WasmEdge_LoaderContext *Loader = WasmEdge_LoaderCreate(Conf);
  WasmEdge_ValidatorContext *Validator = WasmEdge_ValidatorCreate(Conf);

  // 2. --- 關鍵：註冊具名模組 'provider' ---
  WasmEdge_ASTModuleContext *AST_P = NULL;
  WasmEdge_LoaderParseFromFile(Loader, &AST_P, "provider.wasm");
  WasmEdge_ValidatorValidate(Validator, AST_P);

  WasmEdge_String P_Name = WasmEdge_StringCreateByCString("provider");
  WasmEdge_ModuleInstanceContext *P_Inst = NULL;
  // 使用 Register API：這會實例化並把 "provider" 存進 Store 的 Map 裡
  WasmEdge_ExecutorRegister(Exec, &P_Inst, Store, AST_P, P_Name);
  std::cout << "Provider registered at: " << P_Inst << std::endl;

  // 3. --- 載入 Consumer 藍圖 ---
  WasmEdge_ASTModuleContext *AST_C = NULL;
  WasmEdge_LoaderParseFromFile(Loader, &AST_C, "consumer.wasm");
  WasmEdge_ValidatorValidate(Validator, AST_C);

  // 4. --- 產生兩個匿名 Consumer 實例 ---
  WasmEdge_ModuleInstanceContext *ModInstA = NULL;
  WasmEdge_ModuleInstanceContext *ModInstB = NULL;

  // 實例化 A：這時 Executor 會去 Store 找 "provider" 並成功連結
  WasmEdge_ExecutorInstantiate(Exec, &ModInstA, Store, AST_C);
  // 實例化 B：同樣連結到同一個 "provider" 實例
  WasmEdge_ExecutorInstantiate(Exec, &ModInstB, Store, AST_C);

  std::cout << "Anonymous Instance A (Consumer) at: " << ModInstA << std::endl;
  std::cout << "Anonymous Instance B (Consumer) at: " << ModInstB << std::endl;

  // 5. 執行 (略，同前一個範例)
  // ... 執行 ModInstA 與 ModInstB 的 "run" ...

  // 6. 清理
  WasmEdge_ModuleInstanceDelete(ModInstA); // 匿名 A 消失，provider 引用數 -1
  WasmEdge_ModuleInstanceDelete(ModInstB); // 匿名 B 消失，provider 引用數 -1
  WasmEdge_ModuleInstanceDelete(P_Inst); // 具名 provider 消失

  // ... 其他清理 ...
  WasmEdge_StringDelete(P_Name);
  return 0;
}

#include <iostream>
#include <wasmedge/wasmedge.h>

int main() {
  // --- Step 0: 初始化環境 ---
  WasmEdge_ConfigureContext *ConfCxt = WasmEdge_ConfigureCreate();
  WasmEdge_VMContext *VMCxt = WasmEdge_VMCreate(ConfCxt, nullptr);
  WasmEdge_String ProviderName = WasmEdge_StringCreateByCString("provider");

  std::cout << "--- Step 1: Register Named Module [provider] ---" << std::endl;
  WasmEdge_Result Res =
      WasmEdge_VMRegisterModuleFromFile(VMCxt, ProviderName, "provider.wasm");
  if (!WasmEdge_ResultOK(Res)) {
    std::cerr << "Failed to register provider.wasm: "
              << WasmEdge_ResultGetMessage(Res) << std::endl;
    return -1;
  }

  std::cout
      << "\n--- Step 2: Load and Instantiate Anonymous Module [consumer] ---"
      << std::endl;
  WasmEdge_ASTModuleContext *ASTCxt = nullptr;
  WasmEdge_LoaderContext *LoadCxt = WasmEdge_VMGetLoaderContext(VMCxt);

  // 1. 解析 consumer.wasm
  Res = WasmEdge_LoaderParseFromFile(LoadCxt, &ASTCxt, "consumer.wasm");
  if (!WasmEdge_ResultOK(Res)) {
    std::cerr << "Failed to parse consumer.wasm" << std::endl;
    return -1;
  }

  // 2. 將 AST 載入 VM
  WasmEdge_VMLoadWasmFromASTModule(VMCxt, ASTCxt);

  // --- [修正] 2.5 執行驗證 (Validate) ---
  // 必須要有這一步，否則下一步 Instantiate 會回報 WrongVMWorkflow
  Res = WasmEdge_VMValidate(VMCxt);
  if (!WasmEdge_ResultOK(Res)) {
    std::cerr << "Failed to validate consumer.wasm: "
              << WasmEdge_ResultGetMessage(Res) << std::endl;
    return -1;
  }

  // 3. 執行實體化
  Res = WasmEdge_VMInstantiate(VMCxt);
  if (!WasmEdge_ResultOK(Res)) {
    std::cerr << "Failed to instantiate consumer.wasm: "
              << WasmEdge_ResultGetMessage(Res) << std::endl;
    return -1;
  }

  // 取得剛剛產生的匿名實例 (Active Module)
  const WasmEdge_ModuleInstanceContext *ConsumerInst =
      WasmEdge_VMGetActiveModule(VMCxt);
  std::cout << "Consumer Instance (Anonymous) created at: " << ConsumerInst
            << std::endl;

  // std::cout << "\n--- Step 3: Try to Force Delete [provider] while Consumer is "
  //              "alive ---"
  //           << std::endl;
  // // 呼叫你新實作的 API
  // WasmEdge_VMForceDeleteRegisteredModule(VMCxt, ProviderName);
  // std::cout << "Note: Check spdlog output for deferred deletion." << std::endl;

  std::cout << "\n--- Step 3.5: Execute Consumer code after ForceDelete ---"
            << std::endl;

  // 1. 名字要改對，改成 "run"
  WasmEdge_String FuncName = WasmEdge_StringCreateByCString("run");

  // 2. 準備兩個 i32 參數 (例如 10 + 20)
  WasmEdge_Value Params[2] = {WasmEdge_ValueGenI32(10),
                              WasmEdge_ValueGenI32(20)};
  WasmEdge_Value Returns[1];

  // 3. 執行
  Res = WasmEdge_VMExecute(VMCxt, FuncName, Params, 2, Returns, 1);

  if (WasmEdge_ResultOK(Res)) {
    std::cout << "Execution Success! Result: "
              << WasmEdge_ValueGetI32(Returns[0]) << std::endl;
    std::cout << "This proves that even if 'provider' is logically deleted, "
                 "'consumer' can still use its memory."
              << std::endl;
  } else {
    std::cerr << "Execution Failed: " << WasmEdge_ResultGetMessage(Res)
              << std::endl;
  }

  WasmEdge_StringDelete(FuncName);

  std::cout
      << "\n--- Step 4: Now Delete [consumer] to trigger cascading cleanup ---"
      << std::endl;

  // WasmEdge_VMCleanup(VMCxt);

  // --- Step 5: 清理環境 ---
  std::cout << "\n--- Step 5: Final Cleanup ---" << std::endl;
  WasmEdge_VMDelete(VMCxt);
  WasmEdge_ConfigureDelete(ConfCxt);
  WasmEdge_StringDelete(ProviderName);
  WasmEdge_ASTModuleDelete(ASTCxt); // 注意：Load 完後 AST 通常可以提早刪除

  std::cout << "Test finished successfully." << std::endl;
  return 0;
}

{
  ...

  /// \name VM environment.
  /// @{
  const Configure Conf;
  Statistics::Statistics Stat;
  VMStage Stage;
  mutable std::shared_mutex Mutex;
  /// @}

  /// \name VM components.
  /// @{
  Loader::Loader LoaderEngine;
  Validator::Validator ValidatorEngine;
  Executor::Executor ExecutorEngine;
  /// @}

  /// \name VM Storage.
  /// @{
  /// Loaded AST module.
  std::unique_ptr<AST::Module> Mod;
  std::unique_ptr<AST::Component::Component> Comp;
  /// Active module instance.
  // 現在 Active 正要跑的的模組
  std::unique_ptr<Runtime::Instance::ModuleInstance> ActiveModInst;
  std::unique_ptr<Runtime::Instance::ComponentInstance> ActiveCompInst;
  /// Registered module instances by user.
  // 存放的所有模組
  std::vector<std::unique_ptr<Runtime::Instance::ModuleInstance>> RegModInsts;
  /// Built-in module instances mapped to the configurations. For WASI.
   // 存放內建的 Host 模組（如 WASI）
  std::unordered_map<HostRegistration,
                     std::unique_ptr<Runtime::Instance::ModuleInstance>>
      BuiltInModInsts;
  /// Loaded module instances from plug-ins.
  // 存放從 Plug-ins 載入的 Host 模組（如 Tensorflow, Image 等）
  std::vector<std::unique_ptr<Runtime::Instance::ModuleInstance>>
      PlugInModInsts;
  std::vector<std::unique_ptr<Runtime::Instance::ComponentInstance>>
      PlugInCompInsts;
  /// Self-owned store (nullptr if an outside store is assigned in constructor).
  std::unique_ptr<Runtime::StoreManager> Store;
  /// Reference to the store.
  Runtime::StoreManager &StoreRef;
  /// @}
};

/// ======= Functions which are stageless. =======
/// Clean up VM status
void cleanup() {
std::unique_lock Lock(Mutex);
return unsafeCleanup();
}
  
void VM::unsafeCleanup() {
  if (Mod) {
    Mod.reset();
  }
  if (Comp) {
    Comp.reset();
  }
  if (ActiveModInst) {
    ActiveModInst.reset(); // 把 ActiveMod 真的 delete
  }
  if (ActiveCompInst) {
    ActiveCompInst.reset();
  }
  StoreRef.reset(); // 清空 StoreManager 地圖而已
  RegModInsts.clear(); // 把所有註冊模組真的刪除
  Stat.clear();
  unsafeLoadBuiltInHosts();
  unsafeLoadPlugInHosts();
  unsafeRegisterBuiltInHosts();
  unsafeRegisterPlugInHosts();
  LoaderEngine.reset();
  Stage = VMStage::Inited;
}