Oracle VM VirtualBox 5.2.18 Programming Guide and Reference

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

摘要

文档提供了Oracle VM VirtualBox 5.2.18的编程指南和参考资料，详细介绍了如何使用WebService和COM/XPCOM接口进行虚拟机管理。内容涵盖不同操作系统上的实现，包括使用WebService的面向对象方式和原始方式，以及COM/XPCOM的直接使用。文档还介绍了虚拟机的基本概念、事件处理、存储总线类型、设置版本兼容性等关键信息，帮助开发者理解和使用VirtualBox的API。

AI总结

# Oracle VM VirtualBox 5.2.18 编程指南和参考文档总结

## 1. 引言
- **模块化结构**：VirtualBox 采用模块化设计，提供灵活的构建方式。
- **主要 API 实现**：提供WebService（基于 JAX-WS、Python、PHP 等语言的绑定）和 COM/XPCOM 接口。
- **WebService 特性**：支持多种编程语言，通过命令行工具 `vboxwebsrv` 运行，支持认证和日志记录。

## 2. 环境特定说明
- **WebService 使用**：
- **面向对象WebService (OOWS)**：提供 Java、Python 和 PHP 的绑定，简化调用。
- **原始WebService**：适用于其他语言，需处理 XML 和 SOAP 请求。
- **COM/XPCOM 直接使用**：
- 提供 Python 和 C++ 接口。
- 使用胶层（glue layer）屏蔽平台差异，支持跨平台开发。
- 事件队列处理需在主线程中执行。

## 3. 基本 VirtualBox 概念
- **机器信息获取**：通过 `IMachine` 接口读取虚拟机属性。
- **机器设置更改**：通过 `ISession` 管理虚拟机配置。
- **虚拟机启动**：使用 `IMachine::launchVMProcess()` 启动虚拟机。
- **事件处理**：通过 `IEvent` 接口监听和处理 VirtualBox 事件。

## 4. 设置版本
- **版本兼容性**：记录 VirtualBox 设置文件的版本，确保不同版本间的兼容性。
- **关键版本**：
- v1_3：VirtualBox 2.0.12
- v1_17：VirtualBox 5.2.x
- Future：未来版本将支持更高版本。

## 5. 存储总线
- **总线类型**：支持 IDE、SATA、SCSI、SAS、Floppy 和 USB 等存储控制器类型。

## 6. 主要 API 变更日志
- **5.x 版本变更**：
- 移动 `IConsole` 的快照和状态管理方法到 `IMachine`。
- 修改 `ProcessCreateFlag` 的行为和命名。
- **5.0 版本变更**：
- 状态保存、快照管理等方法从 `IConsole` 移到 `IMachine`。

## 7. 其他注意事项
- **编程考虑**：使用WebService时需注意状态管理、对象引用和函数命名规则。
- **C 语言绑定**：通过 `VBoxCAPIGlue` 初始化 API，避免平台差异，支持事件处理和错误处理。

总结：VirtualBox 提供灵活的编程接口，适用于多种语言和平台，通过WebService 和 COM/XPCOM 实现远程管理和控制。文档详细介绍了接口使用、版本兼容性和编程注意事项，帮助开发者高效使用 VirtualBox API。