Najczęściej zadawane pytania
Licencjonowanie i Open Source
Jaką licencję używa Aspose.Cells FOSS dla Rust?
Pakiet jest udostępniony na licencji MIT. Pełny tekst znajduje się w repozytorium jako LICENSE.txt.
Czy mogę go używać w produktach komercyjnych?
Tak. Licencja MIT zezwala na komercyjne wykorzystanie, modyfikację i redystrybucję. Jedynym wymogiem jest zachowanie informacji o prawach autorskich oraz noty licencyjnej w kopiach lub znaczących częściach oprogramowania.
Instalacja i wymagania
Jak zainstalować crate?
Dodaj aspose-cells-foss-rust do swojego Cargo.toml jako zależność git:
# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }Zobacz przewodnik instalacji dla szczegółowego przewodnika krok po kroku.
Jakie wersje Rust są obsługiwane?
Crate celuje w edycję Rust 2021.
Czy wymaga Microsoft Office lub natywnych bibliotek?
Nie. Biblioteka odczytuje i zapisuje format pakietu XLSX bezpośrednio — nie wymaga instalacji Microsoft Office, automatyzacji COM ani zewnętrznego środowiska uruchomieniowego.
Obsługa formatów
Jakie formaty mogą być odczytywane i zapisywane?
XLSX jest obsługiwanym formatem w bieżącym wydaniu: pełny odczyt i zapis w trybie round-trip. Ładowanie odbywa się przez Workbook::load_xlsx (enum LoadFormat obejmuje Auto i Xlsx), a zapisywanie odbywa się przez save, save_xlsx lub save_with_format przy użyciu enum SaveFormat.
Czy potrafi naprawić uszkodzone pliki XLSX?
LoadOptions udostępnia flagi try_repair_package i try_repair_xml, a LoadDiagnostics raportuje napotkane problemy podczas ładowania:
let options = LoadOptions {
try_repair_package: true,
try_repair_xml: true,
..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;API Usage
Jaki jest typowy wzorzec tworzenia skoroszytu?
Utwórz Workbook, określ zakres mutowalnych pożyczeń, zapisz wartości, a potem zapisz:
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")?;Jak zapisać różne typy wartości w komórkach?
Użyj typowanych setterów na mutowalnej komórce: put_value_string, put_value_i32, put_value_bool, put_value_decimal oraz put_value_date_time.
Jak napisać formułę?
Użyj put_formula_with_cached_value, podając wartość, którą Excel ma wyświetlić przed pierwszym przeliczeniem:
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Jak odczytać wartości z załadowanego skoroszytu?
Pobierz arkusz przy użyciu worksheet (lub kolekcji arkuszy), a następnie odczytaj komórki za pomocą get_cells; display_string_value zwraca tekst wyświetlany, a value_type podaje przechowywany typ.
Znane ograniczenia
Czy crate jest dostępny na crates.io?
Jeszcze nie — zainstaluj go jako zależność Cargo z repozytorium GitHub. Cargo zapisuje dokładny commit w Cargo.lock, dzięki czemu kompilacje pozostają powtarzalne.
Czy obsługiwane są formaty inne niż XLSX?
Nie. Obecne wydanie koncentruje się na obsłudze dwukierunkowej XLSX; inne formaty arkuszy kalkulacyjnych nie są odczytywane ani zapisywane.