Guia de implantação do Alchemy Player via MSI

Algumas empresas preferem instalar aplicativos automaticamente por meio de um serviço de TI centralizado. .MSI é um pacote padrão usado pelo Windows para instalar, manter e remover software. Isso pode simplificar o processo quando é necessário coordenar uma instalação em vários computadores e locais. Ele funciona como um banco de dados estruturado que contém todas as instruções e os arquivos necessários para que um programa funcione corretamente nos computadores da sua organização.

Formatos de instalador disponíveis

• MSI - Implantação empresarial via SCCM, Intune, GPO ou outras ferramentas centrais de TI
• EXE - Instalação manual pelos usuários finais (autônomo, com carga idêntica à do MSI)

Modelo de atualização: este MSI é destinado somente a clientes que fazem atualizações manuais. Os clientes do serviço de atualização automática do Alchemy recebem atualizações automaticamente por meio do Serviço de Atualização — não é necessário reimplantar o MSI.

1. O que é instalado

O MSI sempre instala os dois componentes a seguir juntos — não há opção de instalar um sem o outro:

• Alchemy Player - Aplicativo de desktop principal (Alchemy.Sistem.Shell.exe)
• Serviço de atualização do Alchemy Player - Serviço do Windows executado em segundo plano que gerencia futuras atualizações do aplicativo. Garante que o software Alchemy Player esteja atualizado. Se esse serviço estiver desabilitado, o Alchemy Player não poderá verificar nem instalar atualizações. Esse serviço é desinstalado automaticamente quando o Alchemy Player não é detectado no computador.
  • As atualizações automáticas podem ser desabilitadas para clientes que desejam controlar todas as atualizações por conta própria.

Sistemas operacionais Windows do cliente | Em um ambiente limpo, com apenas a instalação básica do Windows: Windows 10 e 11 (sem pré-requisitos). Não são necessários runtimes adicionais do .NET ou do Visual C++.

Sistemas operacionais Windows do cliente | Windows 10 e 11 com o .NET 8.0 ou superior já instalado: a implantação autônoma não entra em conflito com nenhuma versão existente do .NET no computador. O instalador funciona corretamente nos dois cenários.

Se estiver realizando uma atualização, verifique se o Player não está aberto ou em uso. Caso contrário, programe a implantação fora do horário de expediente. Eles devem empacotar TODOS os arquivos e pastas incluídos nos arquivos do instalador, e não apenas o arquivo AlchemyPlayerSetup.exe isoladamente. Não fazer isso pode causar problemas. Por exemplo, se os arquivos do CoursePlayer não forem incluídos, os cursos poderão não ser reproduzidos corretamente.

2. Atalhos criados

Alchemy Player -> Área de trabalho (destino: Alchemy.Sistem.Shell.exe)

Alchemy Player -> Menu Iniciar > Alchemy Systems (destino: Alchemy.Sistem.Shell.exe)

Client Media -> Área de trabalho (destino: pasta CLIENT_MEDIA)

Client Media -> Menu Iniciar > Alchemy Systems (destino: pasta CLIENT_MEDIA)

3. Implantação silenciosa — referência de linha de comando

Comando anterior de instalação silenciosa do EXE (para referência): AlchemyPlayerSetup.exe /s /v"/qn"

O MSI substitui esse comando pela sintaxe padrão do msiexec mostrada abaixo.

Importante: as pastas devem existir antes de executar qualquer comando: o mecanismo msiexec não criará nenhuma pasta automaticamente. Se o diretório especificado não existir, o msiexec não conseguirá iniciar a instalação. Nos exemplos abaixo, C:\Logs é usado — verifique se essa pasta (ou o caminho escolhido) existe no computador de destino antes de executar qualquer comando.

O registro detalhado é altamente recomendado para todas as implantações. Todos os exemplos abaixo incluem o sinalizador /l*v. Armazene os arquivos de log em um diretório protegido, com acesso de leitura restrito, e exclua-os depois de confirmar uma implantação bem-sucedida. Para diagnosticar uma falha, pesquise no log por Return value 3 — isso indica o ponto em que uma ação personalizada falhou

Referência completa do msiexec: para obter uma lista completa das opções e dos parâmetros do msiexec, consulte a documentação da Microsoft: https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec

3.1 Instalação silenciosa (sem interface do usuário)

msiexec /i "AlchemyPlayerSetup.msi" /quiet /l*v "C:\Logs\AlchemyPlayer_install.log"

• /quiet = silencioso, sem interação do usuário
• /l*v = log detalhado (altamente recomendado para todas as implantações)

3.2 Instalação silenciosa — fechamento forçado do aplicativo desabilitado (padrão)

Comportamento padrão. O instalador não fechará o aplicativo à força:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /norestart /l*v "C:\Logs\install.log"

3.3 Instalação silenciosa — fechamento forçado do aplicativo habilitado

Força o fechamento automático do Alchemy Player antes do início da instalação. Use ao implantar em computadores nos quais o Player pode estar em execução:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /forcerestart /l*v "C:\Logs\install.log"

3.4 Atualização silenciosa (de qualquer versão anterior)

Não é necessário executar uma etapa de desinstalação separada. O MSI remove a versão antiga e instala a nova em uma única operação:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /l*v "C:\Logs\AlchemyPlayer_upgrade.log“

3.5 Desinstalação silenciosa

O comando de desinstalação aceita a propriedade PRESERVESETTINGS para controlar se a configuração e os dados existentes serão mantidos ou totalmente removidos.

• PRESERVESETTINGS=1 (Padrão) — Mantém a configuração existente, os dados de conteúdo e as entradas do registro. Use esta opção nos fluxos padrão de desinstalação/reinstalação para evitar a perda das configurações do cliente.
• PRESERVESETTINGS=0 — Executa uma remoção completa de todos os dados do Alchemy Player, incluindo C:\ProgramData\Alchemy Systems\ e todas as entradas do registro. Use esta opção para desativar um computador ou realizar uma reinstalação limpa.

Cenário 1 — Desinstalar preservando as configurações e os dados (padrão recomendado):

msiexec /x "AlchemyPlayerSetup.msi" /quiet PRESERVESETTINGS=1 /l*v"C:\Logs\uninstall.log"

Cenário 2 — Desinstalar e remover todas as configurações e dados (remoção limpa):

msiexec /x "AlchemyPlayerSetup.msi" /quiet PRESERVESETTINGS=0 /l*v"C:\Logs\uninstall.log"

3.6 Diretório de instalação personalizado

msiexec/i"AlchemyPlayerSetup.msi"/quietINSTALLDIR="D:\Apps\AlchemyPlayer\"/l*v"C:\Logs\install.log"

Neste exemplo, INSTALLDIR será criado durante a instalação com o comando msiexec.

4. Referência das propriedades do MSI

INSTALLDIR: Caminho | Padrão: C:\Program Files (x 86)\AlchemySystems/Player | Diretório de instalação do aplicativo

ALLUSERS: 1 | Padrão: 1 | Instalação para todo o sistema — não altere

PRESERVESETTINGS: 0 ou 1 | Padrão: 1 | Preserva a configuração existente durante a atualização

REBOOT: Suprimir / Forçar / Solicitar | Padrão: Solicitar | Controla o comportamento de reinicialização

TRANSFORMS: Caminho do arquivo .mst | Padrão: nenhum | Aplica uma transformação de idioma (consulte a Seção 6)

5. Suporte a idiomas — arquivos de transformação (MST)

A instalação padrão é em inglês (EUA). Passe o arquivo MST correspondente por meio de TRANSFORMS para instalar uma versão localizada.

Exemplo — instalação silenciosa em francês:

msiexec /i"AlchemyPlayerSetup.msi"TRANSFORMS="AlchemyPlayer_1036.mst"/quiet/l*v"C:\Logs\install.log"

Troca de idioma: o idioma do MSI é definido no momento da instalação por meio da propriedade TRANSFORMS e não pode ser alterado sem reinstalação. Para trocar o idioma de um computador implantado, execute uma desinstalação silenciosa (Seção 9.5), seguida de uma nova instalação silenciosa especificando o valor TRANSFORMS desejado. As configurações e os dados existentes são preservados por padrão (PRESERVESETTINGS=1) durante esse processo.

Perguntas frequentes (FAQ)

P: O computador precisa ter o .NET instalado antes da implantação?

R: Não. O Alchemy Player 8.4.0 e versões posteriores são autônomos e não exigem uma instalação separada do .NET. Ele é instalado em um computador limpo, sem pré-requisitos.

P: Ele entra em conflito com o .NET 8.0 ou superior já instalado no computador?

R: Não. Validado em computadores com o .NET 8.0 ou superior pré-instalado. O modelo autônomo coexiste sem problemas com qualquer versão existente do .NET.

P: O que acontece se o computador já tiver uma versão mais recente instalada?

R: O instalador detecta a versão instalada e bloqueia a instalação se uma versão mais recente já estiver presente. A instalação existente não é alterada.

P: Quais drivers acompanham o instalador? Os usuários finais precisam instalar os drivers separadamente?

R: Não. Os componentes a seguir acompanham o MSI e são instalados silenciosamente — os usuários finais não precisam realizar nenhuma etapa manual:

Detalhes do driver para pré-aprovação de segurança: fornecedor: Silicon Laboratories, Inc. | ID de hardware:
SLABCOMM&10C4&EA60 | Certificação: assinado pela WHQL

P: O que é o SQLite DB Browser e por que ele é instalado?

R: O Alchemy Player usa o SQLite como banco de dados interno para armazenar dados localmente em cache (informações do usuário, matrícula, registros de treinamento), o que reduz as chamadas contínuas ao servidor do Alchemy Manager. O SQLite DB Browser é uma ferramenta complementar de visualização incluída em INSTALLDIR\Tools\ apenas para fins de suporte e diagnóstico — não é necessário para a operação normal do Alchemy Player.

P: Devemos configurar exclusões no antivírus para o Alchemy Player?

R: Na maioria dos ambientes, não são necessárias exclusões. Se a verificação do antivírus em tempo real causar problemas de desempenho (como inicialização lenta do aplicativo ou atrasos no acesso a arquivos), considere excluir:

•C:\Program Files (x86)\Alchemy Systems\Player\ •C:\ProgramData\Alchemy Systems\Sistem\

P: Quais regras de firewall são necessárias para o Alchemy Player?

R: O Alchemy Player se conecta de saída ao servidor do Alchemy Manager. Verifique se as regras do firewall permitem tráfego HTTPS de saída do computador instalado para o host do Manager. Nenhuma porta de entrada é necessária.

P: A instalação solicitará uma reinicialização?

R: Normalmente, não. Passe REBOOT=Suppress na linha de comando para garantir que não ocorra nenhuma reinicialização durante a implantação silenciosa.

P: O que acontece com o conteúdo do usuário durante uma atualização?

R: Todo o conteúdo em C:\ProgramData\Alchemy Systems\Sistem\ é preservado. Os arquivos de configuração são automaticamente copiados e restaurados.

P: Usamos o serviço de atualização automática do Alchemy. Precisamos deste MSI para atualizar o Player?

R: Para atualizações de versão do Player, não. Os sistemas configurados para usar o Serviço de Atualização Automática do Alchemy recebem as atualizações do Player automaticamente. No entanto, o MSI ainda pode ser usado para implantações iniciais ou instalações pela primeira vez.

P: O MSI tem a mesma carga do instalador EXE?

R: Sim. Ambos são autônomos e instalam o mesmo aplicativo. O MSI é fornecido para ambientes que exigem implantação baseada em MSI (SCCM, Intune, GPO).

P: Podemos preparar arquivos de configuração personalizados antes da implantação?

R: Sim. Coloque sistem_specific.xml e RF_CODES.txt no diretório ClientConfig do instalador antes de executar o MSI.

P: Com quem devo entrar em contato caso tenha dúvidas adicionais ou específicas?

R: Equipe de implementação — entre em contato com o gerente de implementação da Alchemy
Suporte técnico — Central de atendimento da Alchemy Client Services 888.988.8832

O PDF deste artigo está disponível para download abaixo. Atualmente disponível somente em inglês.