Installation

Instalação de Aspose.BarCode FOSS para Python

Aspose.BarCode FOSS para Python é distribuído como um pacote de Python puro no PyPI. Não há extensões nativas para compilar, nenhuma biblioteca do sistema para instalar e nenhum tempo de execução de terceiros necessário.


Precondições

RequirementDetail
Versão Python3.12 or later
Gestor de pacotespip (juntado com CPython)
Sistema de operaçãoWindows, macOS, Linux (qualquer plataforma que execute CPython)
Ferramentas de compilador / compilaçãoNão é necessário.
Pacotes de sistemasNão é necessário.

1. Instalação via pip

A maneira mais simples de instalar o Aspose.BarCode FOSS é diretamente do PyPI:

pip install aspose-barcode-foss

pip irá baixar e instalar o pacote. Não é necessária nenhuma configuração pós-instalação.

Para instalar uma versão fixa para compilações reproduzíveis:

pip install aspose-barcode-foss==0.1.0

2. Configurar um ambiente virtual

Usar um ambiente virtual mantém a biblioteca isolada de outros projetos Python.

Criar e ativar um ambiente virtual:

# Create the environment
python -m venv .venv

# Activate on Linux / macOS
source .venv/bin/activate

# Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

# Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

Instalar a biblioteca dentro do ambiente ativado:

pip install aspose-barcode-foss

Dependências de registo para a reproducibilidade:

pip freeze > requirements.txt

3. Verificar a instalação

Após a instalação, verifique se a biblioteca importa corretamente:

import aspose_barcode_foss as barcode

bc = barcode.code128("TEST")
print(f"Generated barcode with {bc.symbol.matrix.width}x{bc.symbol.matrix.height} modules")

Você também pode verificar a versão instalada com pip:

pip show aspose-barcode-foss

Isto imprime a versão, autor e licença (MIT).


Iniciação rápida: Gerar um código de barras

O seguinte script gera um código de barras 128 e o salva como SVG:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.code128("Hello World")
svg = bc.to_svg(options=RenderOptions(show_text=True))

with open("barcode.svg", "w") as f:
    f.write(svg)
print("Saved barcode.svg")

Gerar um código QR e salvá-lo como PNG:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())
print("Saved qr.png")

Notas da plataforma

Windows, macOS, Linux: A biblioteca é idêntica em todas as plataformas. Não há caminhos de código específicos para a plataforma ou extensões binárias.

Docker / serverless: Como não há dependências de pacote do sistema, a biblioteca funciona dentro das imagens do Dockers (como python:3.12-slim) sem instalar pacotes adicionais.

CI/CD: Adicionar pip install aspose-barcode-foss à etapa de dependência do seu pipeline de CI. Não é necessário qualquer configuração adicional.


Pasos seguintes

  • Quickstart: Primeiro código de barras com opções de codificação e renderização
  • Licença: Detalhes da licença MIT
  • Guia do desenvolvedor: opções de codificação por simbologia, controles de renderização e exemplos de código

Ver também:

  • Aspose.BarCode para Python Empresa Documentation
 Português