Cài đặt

Cài đặt Aspose.Note FOSS cho Python

Aspose.Note FOSS for Python is distributed via PyPI dưới tên gói aspose-note. Cài đặt yêu cầu Python 3.10 hoặc mới hơn.


1. Standard Install (Recommended)

Cài đặt thư viện lõi bằng pip:

pip install aspose-note

Lệnh này cài đặt aspose.note gói mà không có các phụ thuộc tùy chọn. Nó hỗ trợ mọi tính năng đọc và duyệt. Xuất PDF là không được bao gồm.


2. Install with PDF Export Support

Để bật Document.Save(..., SaveFormat.Pdf), cài đặt với [pdf] extra. Điều này sẽ thêm ReportLab phụ thuộc (reportlab>=3.6):

pip install "aspose-note[pdf]"

Nếu bạn đã cài đặt gói lõi, hãy nâng cấp nó và thêm phần mở rộng trong một lệnh:

pip install --upgrade "aspose-note[pdf]"

Lưu ý: Cố gắng gọi Document.Save với SaveFormat.Pdf không có ReportLab được cài đặt sẽ gây ra một ImportError khi chạy. Hãy cài đặt [pdf] extra trước khi sử dụng chức năng PDF.


3. Virtual Environment (Best Practice)

Sử dụng môi trường ảo để cô lập thư viện khỏi Python hệ thống của bạn:

##Create a virtual environment
python -m venv .venv

##Activate it
##Windows:
.venv\Scripts\activate
##Linux / macOS:
source .venv/bin/activate

##Install (with PDF support)
pip install "aspose-note[pdf]"

4. Editable Install (For Contributors)

Sao chép kho và cài đặt ở chế độ có thể chỉnh sửa để phát triển hoặc chạy các bài kiểm tra trên mã nguồn:

git clone https://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python.git
cd Aspose.Note-FOSS-for-Python

##Editable install with PDF support
pip install -e ".[pdf]"

##Run the test suite
python -m unittest discover -s tests -p "test_*.py" -v

Xác minh

Sau khi cài đặt, xác nhận rằng gói có thể được nhập:

from aspose.note import Document, SaveFormat, FileFormat
print("Aspose.Note FOSS for Python installed successfully.")

Kiểm tra phiên bản đã cài đặt:

pip show aspose-note

Kết quả mong đợi (phiên bản có thể khác):

Name: aspose-note
Version: 26.3.2
Summary: Aspose.Note-compatible Python API for reading OneNote (.one) files
...

Phụ thuộc

Phụ thuộcCần thiết?Mục đích
Python 3.10+LuônPhiên bản ngôn ngữ tối thiểu
reportlab>=3.6Tùy chọn (qua [pdf] bổ sung)Xuất PDF qua Document.Save(..., SaveFormat.Pdf)

Thư viện lõi có không có phụ thuộc bên thứ ba nào bắt buộc. Tất cả việc phân tích nhị phân MS-ONE/OneStore được thực hiện bằng Python thuần trong aspose.note._internal gói con.


Chi tiết gói

Thuộc tínhGiá trị
Tên góiaspose-note
URL PyPIhttps://pypi.org/project/aspose-note/
Đường dẫn importfrom aspose.note import ...
Phiên bản (hiện tại)26.3.2
Python hỗ trợ3.10, 3.11, 3.12
Hệ điều hànhWindows, Linux, macOS (không phụ thuộc vào hệ điều hành)
Giấy phépMIT (Aspose-Split)
Kho mã nguồnhttps://github.com/aspose-note-foss/Aspose.Note-FOSS-for-Python

Tài nguyên bổ sung

 Tiếng Việt