feat(plugin): Fix plugin BoxRef return and Box argument support
- Fixed deadlock in FileBox plugin copyFrom implementation (single lock) - Added TLV Handle (tag=8) parsing in calls.rs for returned BoxRefs - Improved plugin loader with config path consistency and detailed logging - Fixed loader routing for proper Handle type_id/fini_method_id resolution - Added detailed logging for TLV encoding/decoding in plugin_loader_v2 Test docs/examples/plugin_boxref_return.nyash now works correctly: - cloneSelf() returns FileBox Handle properly - copyFrom(Box) accepts plugin Box arguments - Both FileBox instances close and fini correctly 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Moe Charm
194
docs/guides/wasm-guide/rust-dependency-analysis.md
Normal file
194
docs/guides/wasm-guide/rust-dependency-analysis.md
Normal file
@ -0,0 +1,194 @@
|
||||
# 🔍 Nyash WASM実行におけるRust依存性分析
|
||||
|
||||
## 📅 最終更新: 2025-08-15
|
||||
|
||||
## 🎯 概要
|
||||
Nyash WASMの実行時Rust依存性について、Phase 9.77（手動実装）とPhase 9.8+（FFI基盤）を比較分析し、真のRust依存脱却の実現方法を解説。
|
||||
|
||||
## 🔍 重要な発見: 実行時Rust依存性は**ゼロ**
|
||||
|
||||
### **結論**
|
||||
**どちらの方式でも実行時Rust依存はなし！**
|
||||
|
||||
| 方式 | コンパイル時 | 実行時 | 配布ファイル |
|
||||
|------|-------------|--------|-------------|
|
||||
| **Phase 9.77 (手動)** | ❌ Rust必要 | ✅ **Rust不要** | .wasm + .js のみ |
|
||||
| **Phase 9.8+ (FFI)** | ❌ Rust必要 | ✅ **Rust不要** | .wasm + .js のみ |
|
||||
|
||||
## 🛠️ Phase 9.77: 手動実装アプローチ
|
||||
|
||||
### **特徴**
|
||||
- 基本的なCanvas/Console操作を手動でWASM import実装
|
||||
- 緊急復旧に最適（1-2週間で完了）
|
||||
- 実行時はWASM + JavaScriptのみ
|
||||
|
||||
### **実行時依存関係**
|
||||
```mermaid
|
||||
graph LR
|
||||
A[ブラウザー] --> B[app.wasm]
|
||||
A --> C[importObject.js]
|
||||
B --> C
|
||||
style A fill:#4ecdc4
|
||||
style B fill:#f9ca24
|
||||
style C fill:#f0932b
|
||||
```
|
||||
|
||||
### **生成例**
|
||||
```bash
|
||||
# コンパイル時 - Rust必要
|
||||
cargo build --target wasm32-unknown-unknown
|
||||
# → app.wasm 生成
|
||||
|
||||
# 実行時 - Rust完全不要！
|
||||
# ブラウザーでWASM + JavaScriptのみ
|
||||
```
|
||||
|
||||
## 🚀 Phase 9.8+: FFI基盤アプローチ
|
||||
|
||||
### **特徴**
|
||||
- BID（Box Interface Definition）からの自動生成
|
||||
- 新API追加が数分で完了
|
||||
- 長期開発効率の飛躍的向上
|
||||
|
||||
### **自動生成フロー**
|
||||
```mermaid
|
||||
graph TD
|
||||
A[BID YAML定義] --> B[nyash bid gen]
|
||||
B --> C[WASM import宣言]
|
||||
B --> D[JavaScript実装]
|
||||
B --> E[Rust生成コード]
|
||||
C --> F[配布: WASM + JS]
|
||||
D --> F
|
||||
style F fill:#2ed573
|
||||
```
|
||||
|
||||
### **生成コマンド**
|
||||
```bash
|
||||
# BID定義から自動生成
|
||||
nyash bid gen --target wasm bid/canvas.yaml
|
||||
|
||||
# コンパイル
|
||||
cargo build --target wasm32-unknown-unknown
|
||||
|
||||
# 実行時 - Rust完全不要！
|
||||
# 同じくWASM + JavaScriptのみ
|
||||
```
|
||||
|
||||
## 📦 配布ファイル構成（共通）
|
||||
|
||||
どちらの方式でも、配布時は以下のファイルのみ:
|
||||
|
||||
```
|
||||
my_nyash_app/
|
||||
├── app.wasm # コンパイル済みWASM（Rust不要）
|
||||
├── runtime.js # importObject実装（JavaScript）
|
||||
├── index.html # HTMLページ
|
||||
└── README.md # 使用説明
|
||||
```
|
||||
|
||||
## 🌐 実際の実行例
|
||||
|
||||
### **HTMLファイル**（Rust一切不要）
|
||||
```html
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head><title>Nyash App</title></head>
|
||||
<body>
|
||||
<canvas id="gameCanvas" width="400" height="300"></canvas>
|
||||
<script src="runtime.js"></script>
|
||||
<script>
|
||||
// WASMロード・実行（Rust依存なし）
|
||||
WebAssembly.instantiateStreaming(
|
||||
fetch('app.wasm'),
|
||||
importObject
|
||||
).then(instance => {
|
||||
instance.exports.main();
|
||||
});
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
### **実行環境要件**
|
||||
- ✅ モダンブラウザー（Chrome, Firefox, Safari, Edge）
|
||||
- ✅ WebAssembly対応
|
||||
- ❌ Rust不要
|
||||
- ❌ Node.js不要
|
||||
- ❌ 特別なランタイム不要
|
||||
|
||||
## 📊 方式比較詳細
|
||||
|
||||
| 評価軸 | Phase 9.77 手動 | Phase 9.8+ FFI |
|
||||
|--------|-----------------|----------------|
|
||||
| **実行時Rust依存** | ❌ なし | ❌ なし |
|
||||
| **配布ファイル** | WASM + JS | WASM + JS |
|
||||
| **開発時間** | 1-2週間 | 3-4週間 |
|
||||
| **API追加工数** | 数時間（手動） | 数分（自動） |
|
||||
| **保守性** | 低 | 高 |
|
||||
| **拡張性** | 限定的 | 無制限 |
|
||||
| **学習コスト** | 中 | 高 |
|
||||
|
||||
## 🎯 実用的選択指針
|
||||
|
||||
### **Phase 9.77を選ぶべき場合**
|
||||
- ✅ **即座にRust依存脱却したい**
|
||||
- ✅ **基本的なCanvas/Console操作で十分**
|
||||
- ✅ **短期プロジェクト**
|
||||
- ✅ **学習コスト最小化**
|
||||
|
||||
### **Phase 9.8+を選ぶべき場合**
|
||||
- ✅ **長期開発プロジェクト**
|
||||
- ✅ **多様な外部API統合が必要**
|
||||
- ✅ **チーム開発**
|
||||
- ✅ **API拡張の自動化が重要**
|
||||
|
||||
## 💡 戦略的アプローチ
|
||||
|
||||
### **段階的進化パス**
|
||||
```mermaid
|
||||
graph LR
|
||||
A[現在: Rust依存] --> B[Phase 9.77: 手動WASM]
|
||||
B --> C[Phase 9.8+: FFI基盤]
|
||||
C --> D[完全自動化]
|
||||
|
||||
style A fill:#ff6b6b
|
||||
style B fill:#f9ca24
|
||||
style C fill:#4ecdc4
|
||||
style D fill:#2ed573
|
||||
```
|
||||
|
||||
### **推奨戦略**
|
||||
1. **Phase 9.77**: 手動実装で即座にRust依存脱却
|
||||
2. **検証**: 実用性・性能確認
|
||||
3. **Phase 9.8+**: 必要に応じてFFI基盤へ移行
|
||||
|
||||
## 🎉 期待される効果
|
||||
|
||||
### **即時効果（Phase 9.77）**
|
||||
- **Rust依存完全排除**（実行時）
|
||||
- **配布の簡素化**
|
||||
- **ブラウザー単体実行**
|
||||
- **学習コスト削減**
|
||||
|
||||
### **長期効果（Phase 9.8+）**
|
||||
- **開発効率の飛躍的向上**
|
||||
- **API拡張の自動化**
|
||||
- **チーム開発の標準化**
|
||||
- **エコシステム拡充**
|
||||
|
||||
## 🔗 関連ドキュメント
|
||||
|
||||
### **技術仕様**
|
||||
- [FFI/ABI仕様](../reference/box-design/ffi-abi-specification.md)
|
||||
- [実行バックエンド](../execution-backends.md)
|
||||
|
||||
### **実装計画**
|
||||
- [Phase 9.77詳細](../../予定/native-plan/issues/phase_9_77_wasm_emergency.md)
|
||||
- [Copilot Issues](../../予定/native-plan/copilot_issues.txt)
|
||||
|
||||
### **問題分析**
|
||||
- [WASM現在の問題](../../予定/wasm/current_issues.md)
|
||||
|
||||
---
|
||||
|
||||
**この分析により、NyashはWASMを通じて真のRust依存脱却を実現し、ブラウザー環境での自由な実行が可能になります。** 🚀
|
||||
Reference in New Issue
Block a user