Oracle VM VirtualBox 7.0.0 Programming Guide and Reference

• 语言: 英语
• 格式: .pdf
• 来源: download.virtualbox.org

摘要

The document provides a comprehensive guide to programming with Oracle VM VirtualBox 7.0.0. It details the Main API, which offers a modular and extensible interface for interacting with VirtualBox. The guide covers using the API through various programming languages, including Java, Python, PHP, and C, as well as through COM/XPCOM and web services. Key topics include authentication, session management, object references, and event handling. The document also highlights important changes in the API across different versions, such as updates to audio settings, machine creation, and event handling. It emphasizes the need for proper memory management and cleanup of managed object references to avoid resource leaks.

AI总结

《Oracle VM VirtualBox 7.0.0 Programming Guide and Reference》是一份全面的开发文档，主要介绍了VirtualBox的编程接口（Main API）及其使用方法。以下是文档的核心内容总结：

---

### 1. **概述**
- **VirtualBox的模块化设计**：VirtualBox分为多个层次，包括底层的虚拟化引擎（hypervisor）、用户空间代码以及功能模块（如RDP服务器、实时迁移等）。Main API是开发者与VirtualBox交互的核心接口，提供了创建、配置、启动和控制虚拟机的功能。
- **Main API的定义**：Main API是一个高度模块化的接口，支持通过Web服务（基于JAX-WS、Python、PHP等）、COM/XPCOM或C语言绑定进行编程。

---

### 2. **主要API变化**
文档列出了从2.0版本以来的重大API不兼容变化，特别是7.0和6.1版本的主要更新：
- **7.0版本变化**：
- 音频适配器接口移动到新的`IAudioSettings`接口。
- `IVirtualBox::openMachine`方法增加了密码参数。
- 新虚拟机的默认音频驱动改为`AudioDriverType_Default`。
- 主机更新功能重构为新的`IHostUpdateAgent`接口。
- `directoryCopyFromGuest`和`directoryCopyToGuest`方法不再默认递归复制，需通过新标志`DirectoryCopyFlag::Recursive`和`DirectoryCopyFlag::FollowLinks`启用。
- `VBoxEventType Last`重命名为`VBoxEventType End`。
- **6.1版本变化**：
- 将`IMachine`的图形适配器部分移动到新的`IGraphicsAdapter`接口。

---

### 3. **编程接口**
- **Web服务接口**：
- 支持基于JAX-WS、Python和PHP的面向对象Web服务（OOWS）。
- 提供原始Web服务接口，适用于其他语言。
- 管理对象引用（ManagedObjectRef）是Web服务客户端的核心，用于表示COM对象。
- **COM/XPCOM接口**：
- 支持Python、Java、C++、VBScript等多种语言的绑定。
- 事件队列处理和COM对象的生命周期管理是重点。
- **C语言绑定**：
- 从4.3版本开始，VirtualBox提供了一个跨平台的C语言绑定，支持Windows、Linux、MacOS和Solaris。
- 示例程序`tstCAPIGlue.c`展示了如何使用C绑定初始化API、操作虚拟机以及处理事件。

---

### 4. **主要接口和类**
- **IAudioAdapter**：
- 控制虚拟机的音频适配器，包括启用/禁用输入、输出和调整音频控制器类型。
- **IAppliance**：
- 用于导入/导出虚拟机的OVF（Open Virtualization Format）文件，支持多种格式（如`ovf-0.9`、`ovf-1.0`、`opc-1.0`等）。
- 提供虚拟磁盘和虚拟系统描述的管理功能。

---

### 5. **注意事项**
- **版本兼容性**：VirtualBox保证在同一主版本内API兼容，但跨主版本更新可能导致API不兼容。
- **模块化设计**：Main API的设计使得开发者可以灵活地选择所需功能模块，避免不必要的依赖。
- **事件处理和资源管理**：COM对象和管理对象引用的生命周期管理是开发中的重点，需避免内存泄漏和资源未释放问题。
- **平台差异**：C语言绑定和COM/XPCOM的实现需注意平台差异，推荐使用跨平台的C绑定。

---

### 6. **总结**
《VirtualBox 7.0.0 Programming Guide and Reference》为开发者提供了详细的API文档和示例，帮助其通过多种语言和接口与VirtualBox交互。文档重点介绍了API的变化、主要接口的功能以及编程注意事项，是开发者理解和使用VirtualBox SDK的重要参考资料。