Instalação

Instalação do componente Facephi SDK Web.

O SDK Web é uma biblioteca de componentes elementos personalizados compatíveis com qualquer framework atual.

Existem duas versões da biblioteca SDK Web:

• SDK Web WebComponents: Biblioteca web-components, compatível com a maioria dos frameworks e ambientes.

• SDK Web React: Versão de componentes nativos React. Esta biblioteca conta com todas as funcionalidades da versão WebComponents, mas com a sintaxe aplicável ao React.

---

Credenciais de download

Crie um arquivo chamado .npmrc na raiz do seu projeto com o seguinte conteúdo:

@facephi:registry=https://facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:_password=[TU_TOKEN]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:username=[TU_USUARIO]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:email=[TU_EMAIL]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:always-auth=true

Substitua [TU_TOKEN], [TU_USUARIO] e [TU_EMAIL] pelas credenciais fornecidas.

---

Instalação da biblioteca

Existem duas formas principais de integrar o SDK Web da Facephi em seu aplicativo. Por meio de um gerenciador de pacotes ou por CDN. Em ambos os casos, são oferecidas as mesmas funcionalidades.

Instalação por meio de um gerenciador de pacotes

Recomendada para projetos que utilizam frameworks modernos como React, Angular ou Vue.

O pacote do SDK Web está hospedado em um repositório privado de NPM. Siga estas etapas para instalá-lo:

SDK Web Components

Execute o seguinte comando no terminal do seu projeto:

npm install @facephi/sdk-web-wc

Também existem versões para React e Angular com uma versão nativa para esses ambientes. Consulte a seção de integração em frameworks para mais informações.

Certifique-se de que a instalação seja concluída sem erros antes de continuar.

---

Instalação via CDN

Para projetos que não utilizam um gerenciador de pacotes, você pode integrar o SDK usando um link CDN:

import 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';
import { defineCustomElements as defineCustomFacephiSDKElements } from 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';

defineCustomFacephiSDKElements(window);

Isso carregará a versão mais recente do SDK diretamente dos servidores da Facephi.

O restante da integração é o mesmo para ambos os casos.

---

Próximos passos

• Continue com a Configuração inicial.

• Revise os Exemplos de integração.