Installazione

Overview

Questa guida mostra come configurare Aspose.Cells FOSS per C++ sulla tua macchina di sviluppo, compilare la libreria e verificare l’installazione con un programma minimo di creazione di fogli di calcolo.

Prerequisiti

Passo 1 — Clona il repository

Clona il repository sorgente di Aspose.Cells FOSS per C++:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

Passo 2 — Compila gli esempi

Usa la configurazione CMake inclusa per compilare il progetto degli esempi, che compila anche la libreria:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

L’output della compilazione posiziona i binari compilati nella directory build/.

Passo 3 — Includi la libreria nel tuo progetto

Aggiungi le intestazioni della libreria e l’albero dei sorgenti al tuo CMakeLists.txt tramite FetchContent o includendo un percorso locale:

cmake_minimum_required(VERSION 3.15)
project(MyProject CXX)

set(CMAKE_CXX_STANDARD 17)

# Option A: local path
add_subdirectory(path/to/Aspose.Cells-FOSS-for-Cpp)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Aspose.Cells.Foss.Cpp)

Alternativa: Installa tramite NuGet

Se il tuo progetto utilizza già NuGet per la gestione delle dipendenze C++, puoi installare il pacchetto pubblicato invece di compilare dal sorgente:

dotnet add package Aspose.Cells.Cpp.FOSS

Quindi collega il pacchetto nel tuo progetto come di consueto; salta i Passi 1–3 sopra e procedi al Passo 4 per verificare l’installazione.

Passo 4 — Verifica l’installazione

Crea un main.cpp minimale che crei e salvi un file XLSX:

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/WorksheetCollection.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/Cell.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Hello");
    sheet.GetCells()["A1"].PutValue("Hello, Aspose.Cells FOSS!");
    workbook.Save("hello.xlsx");
    return 0;
}

Compila ed esegui. Se hello.xlsx viene creato nella directory di lavoro, l’installazione è avvenuta con successo.

Suggerimenti e buone pratiche

• Usa sempre lo spazio dei nomi Aspose::Cells_FOSS per evitare conflitti di simboli con altre librerie.
• Il punto di ingresso include per la maggior parte delle operazioni è aspose/cells_foss/Workbook.h; includi ulteriori header come Worksheet.h e Cell.h secondo necessità.
• Usa CMake 3.15 o versioni successive; le versioni più vecchie potrebbero non supportare la configurazione di destinazione inclusa.
• Per le build di produzione, passa -DCMAKE_BUILD_TYPE=Release a cmake per abilitare le ottimizzazioni.
• Mantieni la directory del clone come radice della tua libreria; non copiare header individuali — i percorsi di include relativi negli header della libreria dipendono dalla struttura originale delle directory.

Problemi comuni

Prossimi Passi

• License — Rivedere i termini della licenza MIT per Aspose.Cells FOSS per C++.
• Features — Sfoglia tutte le funzionalità di foglio di calcolo supportate.
• Lavorare con la gestione dei fogli di calcolo — Impara le operazioni di workbook e worksheet.

Vedi anche

• Aspose.Cells for C++ — Enterprise Documentation