Aspose.Cells FOSS
C++
Getting Started
Installation

Installation

설치

이 가이드는 개발 머신에서 Aspose.Cells FOSS for C++를 설정하고, 라이브러리를 빌드하며, 최소한의 스프레드시트 생성 프로그램으로 설정을 확인하는 방법을 보여줍니다.

전제 조건

요구 사항세부 사항
C++ 컴파일러C++17 호환 컴파일러 (GCC 9+, Clang 10+, 또는 MSVC 2019+)
CMake버전 3.15 이상
Git최근 버전 중 아무거나
운영 체제Linux, macOS 또는 Windows

1단계 — 리포지토리 복제

다음 Aspose.Cells FOSS for C++ 소스 리포지토리를 복제합니다:

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

2단계 — 샘플 빌드

번들된 CMake 구성을 사용하여 샘플 프로젝트를 빌드합니다. 이 과정에서 라이브러리도 컴파일됩니다.

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

빌드 출력은 컴파일된 바이너리를 build/ 디렉터리에 배치합니다.

단계 3 — 라이브러리를 프로젝트에 포함하기

라이브러리 헤더와 소스 트리를 FetchContent 또는 로컬 경로 포함을 통해 자신의 CMakeLists.txt에 추가합니다:

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)

대안: NuGet를 통해 설치

프로젝트에서 이미 C++ 의존성 관리를 위해 NuGet를 사용하고 있다면, 소스에서 빌드하는 대신 게시된 패키지를 설치할 수 있습니다:

dotnet add package Aspose.Cells.Cpp.FOSS

그런 다음 프로젝트에서 패키지를 일반적으로 링크하십시오; 위의 단계 1–3을 건너뛰고 단계 4로 진행하여 설치를 확인합니다.

단계 4 — 설치 확인

XLSX 파일을 생성하고 저장하는 최소한의 main.cpp를 만들십시오:

#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;
}

빌드하고 실행하십시오. 작업 디렉터리에 hello.xlsx가 생성되면 설치가 성공한 것입니다.

팁 및 모범 사례

  • 다른 라이브러리와의 심볼 충돌을 방지하려면 항상 Aspose::Cells_FOSS 네임스페이스를 사용하십시오.
  • 대부분의 작업에 대한 포함 진입점은 aspose/cells_foss/Workbook.h입니다; 필요에 따라 Worksheet.h 및 Cell.h와 같은 추가 헤더를 포함하십시오.
  • CMake 3.15 이상을 사용하십시오; 이전 버전은 번들된 타깃 구성을 지원하지 않을 수 있습니다.
  • 프로덕션 빌드의 경우 최적화를 활성화하려면 -DCMAKE_BUILD_TYPE=Release를 cmake에 전달하십시오.
  • 클론 디렉터리를 라이브러리 루트로 유지하십시오; 개별 헤더를 복사하지 마세요 — 라이브러리 헤더의 상대 포함 경로는 원본 디렉터리 구조에 의존합니다.

일반적인 문제

문제원인해결
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclude 경로가 구성되지 않음Ensure target_include_directories가 라이브러리의 include/ 폴더를 가리키도록 합니다.
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()라이브러리가 연결되지 않음CMakeLists.txt에 target_link_libraries(MyApp Aspose.Cells.Foss.Cpp)를 추가하십시오
CMake 버전 오류CMake < 3.15CMake를 3.15 이상으로 업그레이드하거나 cmake_minimum_required 버전을 조정하십시오
C++14 모드에서 빌드가 실패합니다표준이 너무 오래되었습니다add_executable 호출 전에 set(CMAKE_CXX_STANDARD 17)를 추가하십시오

다음 단계

참조

 한국어