Cài đặt

Trang này nói về điều gì

Cài đặt Aspose.Slides cho Python thông qua Java trên Windows, Linux hoặc macOS, cấu hình Java và JPype, và xác minh cài đặt bằng một ví dụ hoạt động.

Aspose.Slides cho Python thông qua Java chạy trên Windows, Linux và macOS. Nó sử dụng JPype để truy cập thư viện Java từ Python. Microsoft PowerPoint không bắt buộc.

Yêu cầu trước

Trước khi cài đặt các gói Python, hãy cài đặt Python và một JDK đáp ứng Yêu cầu hệ thống. Trang đó liệt kê các phiên bản tương thích, yêu cầu kiến trúc và bất kỳ phụ thuộc nào cần thiết để biên dịch JPype từ nguồn.

Đặt JAVA_HOME tới thư mục cài đặt JDK, không phải thư mục con bin của nó, và thêm thư mục bin của JDK vào PATH. Mở một terminal mới sau khi thay đổi các biến môi trường.

Cài đặt từ PyPI

Chạy các lệnh sau trong một terminal, không phải tại dấu nhắc Python tương tác. Tạo một thư mục dự án và môi trường ảo để giữ các gói cách biệt với các dự án khác.

Windows

Với trình thông dịch Python bạn chọn có sẵn dưới tên python trong PATH, chạy các lệnh sau trong Command Prompt:

mkdir slides-example
cd slides-example
python -m venv .venv
.venv\Scripts\activate.bat

Linux và macOS

Với phiên bản Python bạn chọn có sẵn dưới tên python3, chạy các lệnh sau trong Bash hoặc zsh:

mkdir slides-example
cd slides-example
python3 -m venv .venv
source .venv/bin/activate

Trên Debian hoặc Ubuntu, nếu việc tạo môi trường thất bại vì ensurepip không có, hãy cài đặt gói python3-venv bằng sudo apt-get install python3-venv, sau đó lặp lại lệnh tạo môi trường. Một phiên bản Python được cài đặt riêng có thể cần gói venv tương thích với phiên bản đó.

Cài đặt các gói

Khi môi trường ảo đang hoạt động, cài đặt JPype và Aspose.Slides:

python -m pip install --upgrade pip
python -m pip install JPype1 aspose-slides-java

Sử dụng python -m pip đảm bảo các gói được cài đặt cho trình thông dịch được dùng để chạy ứng dụng của bạn.

Để cập nhật một bản cài đặt Aspose.Slides hiện có, chạy python -m pip install --upgrade aspose-slides-java trong cùng môi trường.

Cài đặt từ tệp ZIP

Bạn cũng có thể sử dụng thư viện từ trang tải xuống Aspose.Slides:

Cài đặt Python và Java như mô tả trong Yêu cầu trước.
Tạo và kích hoạt một môi trường ảo bằng cách sử dụng các hướng dẫn ở trên.
Cài đặt JPype bằng python -m pip install JPype1.
Tải xuống và giải nén tệp ZIP Aspose.Slides cho Python thông qua Java.
Xác định thư mục gói asposeslides đã giải nén. Giữ toàn bộ nội dung của nó, bao gồm thư mục lib và tệp JAR, cùng nhau.
Đặt example.py từ phần tiếp theo bên cạnh thư mục asposeslides để Python có thể nhập gói. Tệp nén đã có example.py riêng cạnh asposeslides; thay thế nó bằng tệp dưới đây.

Xác minh cài đặt

Lưu đoạn mã sau dưới dạng example.py. Nó tạo một bản trình chiếu với một hộp văn bản và lưu nó dưới tên out.pptx trong thư mục làm việc hiện tại.

import jpype
import asposeslides

jpype.startJVM()

try:
    from asposeslides.api import Presentation, SaveFormat, ShapeType

    presentation = Presentation()
    try:
        slide = presentation.getSlides().get_Item(0)
        shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 500, 80)
        shape.getTextFrame().setText("Aspose.Slides is ready!")
        presentation.save("out.pptx", SaveFormat.Pptx)
    finally:
        presentation.dispose()
finally:
    jpype.shutdownJVM()

Khi môi trường ảo đang hoạt động, chạy ví dụ từ thư mục chứa example.py:

python example.py

Việc nhập asposeslides đăng ký thư viện Java được đóng gói trước khi JVM khởi động. Nhập asposeslides.api sau khi JVM đã bắt đầu, và giải phóng tài nguyên bản trình chiếu trước khi tắt nó.

Note

Nếu không có giấy phép, đầu ra sẽ có dấu bản quyền đánh giá. Xem Đánh giá Aspose.Slides để biết các hạn chế của bản đánh giá và thông tin về giấy phép tạm thời.

Câu hỏi thường gặp

Tại sao Python báo rằng không thể tìm thấy hoặc tải JVM?

Kiểm tra JAVA_HOME trỏ tới một JDK tương thích với Python và cài đặt JPype của bạn, như mô tả trong Yêu cầu hệ thống. Xem hướng dẫn khắc phục sự cố cài đặt JPype để biết thêm các kiểm tra.

Tại sao Python báo rằng asposeslides bị thiếu sau khi cài đặt?

Gói có thể đã được cài đặt cho một trình thông dịch Python khác. Kích hoạt môi trường ảo được dùng để cài đặt và chạy python -m pip show aspose-slides-java. Đối với cài đặt ZIP, đảm bảo rằng thư mục asposeslides nằm cạnh script của bạn hoặc có sẵn trên đường dẫn tìm kiếm mô-đun của Python.

Tôi có thể chạy ví dụ liên tục trong một notebook không?

Ví dụ này được thiết kế cho một tiến trình Python độc lập. Trước khi điều chỉnh nó để thực thi liên tục trong notebook, hãy xem Các giới hạn và khác biệt API để biết về vòng đời JVM và hướng dẫn notebook.

Tại sao pip thất bại với CERTIFICATE_VERIFY_FAILED?

Nếu mạng của bạn sử dụng proxy kiểm tra HTTPS, pip phải tin tưởng cơ quan cấp chứng chỉ của nó. Cấu hình gói CA tin cậy bằng tùy chọn --cert của pip hoặc biến môi trường PIP_CERT, theo hướng dẫn chứng chỉ HTTPS của pip. Cấu hình cần thiết phụ thuộc vào mạng và phiên bản pip của bạn.

Yêu cầu hệ thống Cấp phép