Para otimizar o gerenciamento de ativos em toda a equipe ou em vários objetos, você pode converter ativos individuais ou hierarquias de ativos em pacotes e reutilizá-los em várias experiências. Quando um pacote é atualizado, você ou os membros da sua equipe podem atualizar cópias específicas para a versão mais atual, atualizar todas as cópias em uma experiência, ou definir cópias específicas para atualização automática. Os pacotes também incluem um mecanismo de configuração que permite que os criadores e editores de pacote incluam opções para personalizar o comportamento de um pacote.
Criação de pacotes
Um pacote pode ser criado a partir de nó único ou nó raiz da sub-árvore no modelo de dados.
Na janela Explorador, clique com o botão direito do mouse no objeto/nó desejado e selecione Converter para pacote no menu contextual.
Na janela de diálogo, preencha os detalhes solicitados. Em particular, se você estiver trabalhando em um grupo, estabeleça a Propriedade ao grupo desejado no qual você tem permissão para criar/editar experiências de grupo.
As transferências de propriedade não são suportadas pelo sistema de ativos, então escolha o proprietário com atenção ao criar um pacote.Clique no botão Enviar.
Assim que estiver concluído, um símbolo de "corrente" sobre o ícone de objeto o identifica como um pacote. Além disso, você verá um novo objeto PackageLink vinculado ao objeto.
O objeto PackageLink não deve ser apagado ou revinculado. Fazer isso para qualquer cópia de pacote quebra a associação com a versão publicada e converte a cópia de volta em um objeto normal.
Inserção de pacotes
Para inserir um pacote que ainda não existe no local atual, você deve inserí-lo inicialmente na Caixa de ferramentas sob essas diretrizes:
- A partir de Inventário → Meus Pacotes para pacotes que você publicou ou obteve a partir do Mercado do Criador.
- A partir de Criações → Pacotes de grupo para publicados por membros do seu grupo (incluindo você mesmo).
Assim que você inserir um pacote em um modelo de dados de um local, ele aparece na pasta Pacotes do Gerenciador de ativos e permanece lá mesmo que você apague todas as cópias dele depois. No entanto, quando você publica o local, a pasta será atualizada para refletir apenas pacotes usados no local.
Modificação de pacotes
Você pode editar pacotes e suas pastas secundárias como qualquer outro objeto. Na primeira edição que modifica uma instância de um pacote, uma caixa de diálogo de alerta é exibida, trazendo um aviso avançado de que um pacote modificado não pode ser atualizado por qualquer meio e deve ser revertido para desfazer uma série de edições.
A maioria das edições sinalizarão o pacote como modificado, embora as seguintes mudanças não são consideradas modificações de pacote:
| Editar | Modificação de pacote |
|---|---|
| Alteração do nome no nó de raiz. | não |
| Alteração da posição ou rotação do nó raíz de um pacote que é um Class. BasePart, Class. Model, ou Class. GuiObject. | não |
| Alteração da propriedade habilitada de um nó raiz Class. GuiObjectcomo um Class. ScreenGui, Class. SurfaceGui, ou `Class. | não |
| Alteração de uma referência de peça de um Class. Weld dentro do pacote que faz referência a uma instância fora do pacote. | não |
Uma vez modificados, os pacotes com alterações não publicadas são marcados com um ponto amarelo na hierarquia do Explorador.
Adicionar ou atualizar configurações
Você pode incluir atributos de instância na raiz de um pacote para personalizar seu comportamento, por exemplo, a velocidade máxima de um veículo empacotado ou tempo de sonorização de um botão empacotado.
Quando você publica um pacote, o conjunto atual de atributos/valores se tornará as configurações padrão do pacote. Em qualquer cópia de um pacote, as configurações são mostradas em itálico em negrito, e esses valores de atributo podem ser alterados por instância. Quando as cópias do pacote são atualizadas, os valores de configuração modificados serão preservados, enquanto outros atributos serão atualizados para o valor padrão mais recente.
Atualmente, a única forma de lidar com os valores de configuração é adicionar scripts no pacote que lê e aplica o comportamento com base na configuração no tempo de execução.
Se você simplesmente quiser atualizar os valores padrão para as configurações, você pode alterar esses valores de atributo e republicar o pacote (o pacote não será sinalizado como modificado nesse caso). Se desejar publicar outras modificações mas não alterar os valores de configuração padrão, você deve publicar em um pacote sem nenhuma alteração de valores ou reverter as configurações para os padrões deles antes de publicar.
Pacotes aninhados
Você pode aninhar pacotes dentro de outros pacotes para manter e colaborar em hierarquias complexas, como uma série de mecânica de veículo que pode ser modificada independentemente do pacote principal do veículo.
Se você modificar um pacote aninhado, tanto o pacote aninhado e o pacote principal serão considerados modificados. Você deve publicar as alterações a qualquer pacote aninhado antes de poder publicar alterações em seu pacote principal, já que a publicação do principal deve marcá-lo como atual/não modificado e pode entrar em conflito com as modificações do pacote aninhado.
Scripts de pacote
Cada script dentro de um pacote não modificado é apenas leitura e mostra uma modificação no topo com um hyperlink para desbloquear o script.
Clicar no hyperlink:
- Sinaliza o pacote como modificado independentemente se você editar o script.
- Remove a notificação/hyperlink de outros scripts dentro do pacote.
Assim que o pacote é publicado e movido para um estado não modificado, os scripts abaixo dele se tornam apenas leitura com um hyperlink para modificar.
Publicação de alteração de pacotes
Você pode publicar um pacote modificado (marcado com um ponto amarelo) para deixar essas modificações disponíveis para outras cópias do pacote em todo o local e em todas as experiências. Observe que não é necessário publicar um pacote modificado antes de publicar um local (a versão modificada será salva junto com o local para iteração futura).
Para publicar alterações em um pacote:
Na janela Explorador, clique com o botão direito do mouse na cópia modificada (marcada com um ponto amarelo) e selecione Publicar para o pacote.
Para cópias de pacotes definidas como atualização automática, o Studio irá puxar a versão atualizada imediatamente. Outras cópias serão marcadas com um ícone verde de sincronização ao lado do nome e você pode atualizar individualmente ou atualizar em massa conforme necessário.
Atualização de cópias desatualizadas
Você pode atualizar cópias desatualizadas de pacotes para a versão mais recente ou você pode continuar a usar a versão mais antiga.
Para atualizar uma ou mais cópias de pacote para a versão mais recente:
Na janela Explorador, localize as cópias desatualizadas pelo ícone de sincronização verde ao lado do seu nome.
Clique com o botão direito do mouse em uma única cópia desatualizada e selecione Receber pacote mais recente no menu contextual ou selecione várias cópias (pelo menos uma delas modificada), clique no botão direito do mouse e selecione Receber mais recente para pacotes selecionados.
A opção de menu Receber mais recente[ é desativada se alguma das cópias de pacote for modificada. Se você estiver trabalhando em uma série de alterações não publicadas, você precisará reverter as alterações antes de conseguir a versão mais recente.
Atualizações em massa
O uso extensivo de pacotes pode resultar em muitas cópias de pacotes em vários lugares em uma experiência. Além da sincronização individual e das atualizações automáticas, você pode atualizar todas as cópias de um pacote por meio de atualização em massa.
(Recomendado) Feche outras instâncias do Studio com algum dos locais de experiência abertos; isso impede que outras instâncias não salvas de um lugar substituam as suas atualizações.
Na janela Explorador, clique com o botão direito no pacote desejado e selecione Atualizar tudo no menu contextual.
Na janela pop-up, abaixo dos detalhes de versão/data, marque Todos para selecionar todos os lugares na experiência ou selecione apenas os locais específicos para aplicar a atualização em massa.
Clique no botão Atualizar.
A atualização em massa de pacotes salva automaticamente os locais selecionados mas não os publica, então você precisa publicá-los separadamente para ver as mudanças.
Atualizações automáticas
Para facilitar a sincronização, você pode habilitar uma atualização automática da cópia de pacote sempre que uma versão mais recente for publicada e quando existir dentro de uma sessão aberta do Studio.
Na janela Explorer, expanda a árvore de hierarquia do pacote e selecione o objeto PackageLink.
Na janela Propriedades, habilite a propriedade Atualização automática. Essa propriedade só se aplica ao pacote principal de nível mais alto na hierarquia de pacotes aninhados, ou seja, as atualizações automáticas só ocorrerão quando um pacote principal for atualizado.
A atualização automática não se aplica a cópias de pacotes modificadas. Uma vez modificada a instância do pacote, a propriedade de Atualização automática fica desativada e é ignorada.
Compartilhamento e níveis de acesso
Caso desejado, você pode compartilhar pacotes com amigos e conceder acesso a funções de usuário específicas dentro do seu grupo.
No Explorador, na Caixa de ferramentas ou no Gerenciador de ativos, clique com o botão direito do mouse no pacote desejado e selecione Detalhes do pacote no menu contextual.
Na janela pop-up, selecione Permissões na coluna à esquerda para revelar opções de compartilhamento/acesso para pacotes de propriedade de grupo ou usuário.
Para um pacote de propriedade de um grupo, expanda a árvore de funções clicando no › ao lado do ícone do grupo, em seguida escolha um nível de permissão para cada função. As caixas de seleção que estão desbotadas/desativadas indicam que a permissão já está configurada para aquela função e não pode ser alterada nessa janela.
Permissão Descrição Editar Membros da função poderão usar, visualizar e editar as versões atuais e anteriores, incluindo publicar alterações nele. Conceder acesso de edição a uma função dessa janela só concede acesso a um pacote específico. Sem acesso Membros da função não terão acesso a nenhuma versão nova do pacote, embora eles continuarão tendo acesso às versões atuais e anteriores. Para um pacote de propriedade do usuário, busque um amigo por meio do campo de pesquisa, clique em seu avatar/nome de usuário e escolha um nível de permissão.
Permissão Descrição Uso e Visualização O usuário terá a possibilidade de usar e visualizar (mas não editar) as versões atuais e anteriores. Uma vez que você fornecer essa capacidade a um usuário, você não poderá revogar o acesso a uma cópia já inserida na sua experiência; a revogação do acesso impedirá a reinserção ou atualização dos pacotes, mas as cópias de pacotes no modelo de dado deles permanecerão intactas. Editar O usuário poderá usar, visualizar e editar as versões atuais e anteriores, incluindo a publicação de alterações nele.
Reversão de alterações de pacote
Em vez de desfazer uma série inteira de alterações de pacote uma a uma, você pode reverter alterações não publicadas em uma só ação, restaurar um pacote para uma versão anterior ou reverter as alterações para configurações específicas.
Reverter alterações não publicadas
Para desfazer uma série de alterações não publicadas:
Na janela Explorador, localize as cópias modificadas pelo ponto amarelo ao lado do seu nome.
Clique com o botão direito do mouse em uma única cópia modificada e selecione Desfazer alterações no pacote do menu contextual ou selecione várias cópias (ou pelo menos uma delas modificada), clique com o botão direito e selecione Desfazer alterações para pacotes selecionados.
Restaurar para a versão
Para restaurar um pacote para uma versão publicada anteriormente:
No Explorador, na Caixa de ferramentas ou no Gerenciador de ativos, clique com o botão direito do mouse no pacote desejado e selecione Detalhes do pacote no menu contextual.
Na janela pop-up, selecione Versões na coluna da esquerda. A versão publicada atualmente e as versões publicadas anteriormente aparecem (V1, V2, ...) juntamente com a data/hora em que foram publicadas.
Clique na marca de seleção ao lado da versão deseja restaurar e clique em Enviar.
Reverter alterações em um pacote não redefine a configuração para o padrão. Consulte Reverter configuração.
Reverter configurações
Para reverter qualquer atributo de configuração para seu padrão, selecione a opção Redefinir no menu de engrenagem na seção Atributos da janela Propriedades.
Comparação de alterações de Script
Quando um objeto de pacote contém scripts ou o próprio script é um pacote, você pode comparar diferenças linha a linha usando uma ferramenta de diferenciação incorporada. Isso pode ajudar você a decidir atualizar bem como explorar o que mais na experiência pode precisar de edição para fazer a atualização compatível.
Para comparar as alterações de script:
Na janela Explorer, clique com o botão direito do mouse em um pacote modificado ou desatualizado. Lembre-se de que o pacote deve ser um Script ou conter scripts.
Selecione Visualizar alterações de Script do menu de contexto.
Na aba Resultado da Dif que abre, compare todas as alterações entre a cópia de pacote atual e a última versão publicada ou local, semelhante aos aplicativos e controle de fonte.
Nessa comparação de exemplo, o comando print() na linha 1 foi modificado. A linha destacada em vermelho mostra a linha 1 como ela existe na cópia de script desatualizada, enquanto a linha verde imediatamente após mostra a linha 1 como ela existe no pacote de script publicado. Além disso, duas linhas novas foram adicionadas ao pacote de script publicado: uma quebra vazia na linha 2 e um novo comando print() na linha 3.
