Premium edição

Marca de teste e avaliação

Resumo geral

O NextPDF Premium pode ser avaliado com todos os recursos habilitados. Durante uma avaliação, os PDFs gerados trazem uma marca de avaliação visível, para que a saída de avaliação não seja confundida com a saída de produção. Uma licença paga remove essa marca sem nenhuma alteração de código. Esta página descreve apenas esse comportamento. Ela não oferece nenhuma garantia e não faz nenhuma declaração sobre elegibilidade ou efeito jurídico; os termos que se aplicam à sua avaliação ou assinatura são definidos exclusivamente pelo seu contrato de licença.

Instalação

O comportamento de teste e a marca de avaliação fazem parte do NextPDF Premium e não exigem nenhum pacote adicional.

composer require nextpdf/premium

Visão conceitual

O runtime tem um modo de marca com dois estados:

None — sem marca de avaliação. A saída paga e normal nunca é modificada.
Marca d’água de avaliação — uma marca de avaliação visível é aplicada aos PDFs gerados.

O padrão é None. A saída paga não é modificada de forma alguma. O estado de marca d’água de avaliação é ativado pelo licenciamento de avaliação ou de teste — isto é, a própria licença determina se a marca de avaliação é aplicada. Você não a alterna manualmente no código de produção, e uma licença paga não produz saída com marca.

Uma licença é avaliada em um de vários estados. Uma licença paga ou de avaliação ativa concede acesso completo. Uma licença paga vencida entra em um período de carência no qual o acesso continua, e depois em um estado de fallback perpétuo no qual a versão instalada continua funcionando, embora atualizações e suporte deixem de ser concedidos. Uma licença de avaliação expirada restringe o runtime. Quando nenhuma licença está presente, apenas as capacidades de nível Core estão disponíveis. As durações precisas e os termos associados a cada estado são definidos pelo seu contrato de licença.

Superfície da API

Conceito	Comportamento
Modo de marca	Dois estados: sem marca (padrão), ou marca d’água de avaliação. Selecionado pela licença, não pelo código do aplicativo.
Marca d’água de avaliação	Uma marca d’água de texto diagonal visível em cada página, mais um marcador de avaliação anexado aos metadados de produtor do documento e prefixado aos seus metadados de assunto.
Saída paga	O modo de marca é None. A saída é byte a byte não modificada pelo subsistema de marca.

O subsistema de marca é entregue pelo pacote nextpdf/enterprise e restrito sob o código de capacidade enterprise.branding. Ele faz parte do NextPDF Premium e governa o comportamento de avaliação em todas as edições; ele é documentado aqui em nível de comportamento e é orientado inteiramente pela licença, não pelo código do aplicativo.

O que aciona a marca de avaliação

A marca de avaliação é aplicada quando a licença ativa é uma concessão de avaliação ou de teste. Concretamente, durante uma avaliação:

Cada página recebe uma marca d’água diagonal cinza-claro renderizada como conteúdo da página.
Os metadados de produtor do documento ganham um sufixo de avaliação.
Os metadados de assunto do documento ganham um prefixo de avaliação.

A marca d’água é desenhada em um estado gráfico isolado, de modo que ela não altera o conteúdo da página ao redor nem o layout do seu próprio documento. Ela marca a saída como saída de avaliação; ela não degrada a qualidade de renderização nem remove recursos. Durante uma avaliação, você pode exercitar o conjunto completo de recursos do Premium.

Como uma licença paga remove a marca

Quando uma licença paga (não de avaliação) está ativa, o modo de marca é None. O subsistema de marca não faz nenhuma modificação no PDF: sem marca d’água, sem sufixo de produtor, sem prefixo de assunto. A saída é idêntica à saída produzida sem nenhum subsistema de marca.

Remover a marca de avaliação, portanto, não exige nenhuma alteração de código. Instale uma licença paga, e o próximo documento que o seu aplicativo gerar estará sem marca. Não há um “build de produção” separado da biblioteca e nenhum sinalizador de recurso para alternar no seu código.

Casos extremos e armadilhas

A marca aparece após uma assinatura vencer e entrar em um estado tipo avaliação. Isso reflete o estado da licença, não um defeito. Verifique o status da sua licença e renove pelo portal de licenças.
O texto da marca d’água se sobrepõe ao conteúdo. A marca d’água é centralizada e diagonal por design, para que a saída de avaliação seja inequívoca. Ela é removida inteiramente por uma licença paga; ela não foi pensada para ser ajustada para produção.
Marcadores de metadados na saída de avaliação. Os campos de produtor e de assunto carregam marcadores de avaliação durante uma avaliação. Eles estão ausentes sob uma licença paga.
Nenhuma licença presente. Apenas as capacidades de nível Core estão disponíveis; as capacidades do Premium não são habilitadas até que uma licença seja instalada.

Desempenho

A marca d’água é um pequeno fluxo de conteúdo PDF fixo adicionado por página e tem impacto desprezível no tempo ou no tamanho de geração do documento. Sob uma licença paga, o subsistema de marca não realiza nenhum trabalho. O orçamento de desempenho da página reflete a renderização da documentação.

Notas de segurança

A marca de avaliação é um marcador de visibilidade, não um controle de segurança. Ela indica que a saída foi produzida sob uma licença de avaliação. Ela não é uma assinatura digital e não deve ser usada como tal. Para uma saída com evidência de adulteração, use as capacidades de assinatura descritas na matriz de recursos. A licença que seleciona o modo de marca é um envelope assinado cuja assinatura do emissor o runtime verifica.

Conformidade

Nenhuma conformidade com padrões é reivindicada para esta página. Esta página descreve apenas o comportamento em tempo de execução. Ela não declara nem implica nenhuma garantia, certificação ou elegibilidade. Os termos da sua avaliação ou assinatura são definidos exclusivamente pelo seu contrato de licença; consulte esse contrato ou entre em contato com a equipe de vendas.