Preguntas Frecuentes
Licencias & Código Abierto
¿Qué licencia usa Aspose.Cells FOSS para Rust?
El crate se publica bajo la Licencia MIT. El texto completo se incluye en el repositorio como LICENSE.txt.
¿Puedo usarlo en productos comerciales?
Sí. La Licencia MIT permite el uso comercial, la modificación y la redistribución. El único requisito es conservar el aviso de derechos de autor y la licencia en copias o partes sustanciales del software.
Instalación & Requisitos
¿Cómo instalo el crate?
Agrega aspose-cells-foss-rust a tu Cargo.toml como una dependencia git:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }Ver el guía de instalación para una guía paso a paso.
¿Qué versiones de Rust son compatibles?
El crate apunta a la edición 2021 de Rust.
¿Requiere Microsoft Office o bibliotecas nativas?
No. La biblioteca lee y escribe el formato de paquete XLSX directamente — no se necesita instalación de Microsoft Office, automatización COM ni tiempo de ejecución externo.
Compatibilidad de formatos
¿Qué formatos se pueden leer y escribir?
XLSX es el formato compatible en la versión actual: lectura y escritura completas de ida y vuelta. La carga pasa por Workbook::load_xlsx (el enum LoadFormat cubre Auto y Xlsx), y el guardado pasa por save, save_xlsx o save_with_format con el enum SaveFormat.
¿Puede reparar archivos XLSX dañados?
LoadOptions expone las banderas try_repair_package y try_repair_xml, y LoadDiagnostics informa de los problemas encontrados durante la carga:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
¿Cuál es el patrón típico para crear un libro de trabajo?
Crea un Workbook, delimita los préstamos mutables, escribe valores y luego guarda:
let mut workbook = Workbook::new();
{
let mut worksheets = workbook.get_worksheets_mut();
let sheet = worksheets.get(0)?;
let mut cells = sheet.get_cells_mut();
cells.get("A1")?.put_value_string("Hello")?;
}
workbook.save("hello.xlsx")?;¿Cómo escribo diferentes tipos de valor en celdas?
Utilice los setters tipados en una celda mutable: put_value_string, put_value_i32, put_value_bool, put_value_decimal y put_value_date_time.
¿Cómo escribo una fórmula?
Utilice put_formula_with_cached_value, proporcionando el valor que Excel debe mostrar antes de su primer recálculo:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;¿Cómo leo los valores de un libro de trabajo cargado?
Obtenga la hoja con worksheet (o la colección de hojas de cálculo), luego lea las celdas mediante get_cells; display_string_value devuelve el texto visible y value_type informa el tipo almacenado.
Limitaciones conocidas
¿Está el crate en crates.io?
Aún no — instálelo como una dependencia git de Cargo desde el repositorio GitHub. Cargo registra el commit exacto en Cargo.lock, por lo que las compilaciones siguen siendo reproducibles.
¿Se admiten formatos distintos a XLSX?
No. La versión actual se centra en el proceso de ida y vuelta de XLSX; otros formatos de hoja de cálculo no se leen ni se escriben.
