Partilhar via

Use a ferramenta SolutionPackager para compactar e extrair um arquivo de soluções

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

O SolutionPackager é uma ferramenta que pode corromper de forma reversível um arquivo de solução compactado Microsoft Dynamics 365 em vários arquivos XML e outros arquivos para que esses arquivos possam ser facilmente gerenciados por um sistema de controle de fonte. As seções a seguir mostram como executar a ferramenta e como usá-la com soluções gerenciadas e não gerenciadas.

Neste tópico

Onde encontrar a ferramenta SolutionPackager

Argumentos de linha de comando SolutionPackager

Use o argumento de comando do /mapa

  • Mapeamento de pasta

  • Mapeamento de arquivo a arquivo

  • Mapeamento do arquivo ao caminho

  • Mapeamento de exemplo

Soluções gerenciadas e não gerenciadas

Onde encontrar a ferramenta SolutionPackager

A ferramenta SolutionPackager.exe pode ser encontrada na pasta Bin do download SDK do Microsoft Dynamics 365. Baixe o pacote do SDK do Microsoft Dynamics CRM.

Argumentos de linha de comando SolutionPackager

O SolutionPackager é uma ferramenta de linha de comando que pode ser executada com os parâmetros identificados na tabela a seguir.

Argumento

Descrição

/action: {Extract|Pack}

Necessário. Ação a executar. A ação pode ser para extrair um arquivo de solução .zip para uma pasta, ou para criar uma pasta em um arquivo .zip.

/zipfile: <file path>

Necessário. O caminho e o nome de um arquivo de solução .zip. Ao extrair, o arquivo deve existir e será lido. Ao embalar, o arquivo é substituído.

/folder: <folder path>

Necessário. O caminho para uma pasta. Ao extrair, esta pasta é criada e preenchida com arquivos de componentes. Ao embalar, essa pasta já deve existir e conter arquivos de componentes extraídos anteriormente.

/packagetype: {Unmanaged|Managed|Both}

Opcional. O tipo de pacote para processar. O valor padrão não é gerenciado. Este argumento pode ser omitido na maioria das ocasiões, pois o tipo de pacote pode ser lido de dentro do arquivo .zip ou dos arquivos de componentes. Ao extrair e o Both for especificado, os arquivos de solução gerenciados e não gerenciados .zip devem estar presentes e ser processados em uma única pasta. Ao embalar e o Both for especificado, os arquivos de solução gerenciados e não gerenciados .zip serão gerados a partir de uma pasta. Para obter mais informações, consulte a seção sobre como trabalhar com soluções gerenciadas e não gerenciadas mais adiante neste tópico.

/allowWrite:{Yes|No}

Opcional. O valor padrão é Yes. Este argumento é usado somente durante a extração. Quando o /allowWrite:No for especificado, a ferramenta executa todas as operações, mas é impedida de escrever ou excluir qualquer arquivo. A operação de extração pode ser avaliada com segurança sem substituir ou excluir os arquivos existentes.

/allowDelete:{Yes|No|Prompt}

Opcional. O valor padrão é Prompt. Este argumento é usado somente durante a extração. Quando o /allowDelete:Yes for especificado, todos os arquivos presentes na pasta especificada pelo parâmetro /folder que não forem esperados serão automaticamente excluídos. Quando o /allowDelete:No não for especificado, não ocorrerá nenhuma exclusão. Quando o /allowDelete:Prompt for especificado, o usuário é solicitado pelo console a permitir ou recusar todas as operações de exclusão. Observe que se o /allowWrite:No for especificado, não ocorrerá nenhuma exclusão mesmo se o /allowDelete:Yes também for especificado.

/clobber

Opcional. Este argumento é usado somente durante a extração. Quando o /clobber for especificado, os arquivos que possuem o atributo somente leitura são substituídos ou excluídos. Quando não especificado, os arquivos com o atributo somente leitura não são substituídos ou excluídos.

/errorlevel: {Off|Error|Warning|Info|Verbose}

Opcional. O valor padrão é Info. Este argumento indica o nível de informações do log de saída.

/map: <file path>

Opcional. O caminho e o nome de um arquivo .xml que contém diretivas de mapeamento de arquivos. Quando usado durante uma extração, os arquivos normalmente lidos de dentro da pasta especificada pelo parâmetro /folder são lidos a partir de locais alternados conforme especificado no arquivo de mapeamento. Durante a operação de pacote, os arquivos que atendem às diretrizes não são escritos.

/nologo

Opcional. Omitir a faixa no tempo de execução.

/log: <file path>

Opcional. Um caminho e o nome ao arquivo de log. Se o arquivo já existe, novas informações de log são acrescentadas ao arquivo.

@ <file path>

Opcional. Um caminho e o nome ao arquivo que contém argumentos de linha de comando para a ferramenta.

/sourceLoc: <string>

Opcional. Este argumento gera um arquivo de recurso modelo, e é válido somente no extração.

Os valores possíveis são auto ou um código LCID/ISO para o idioma que você deseja exportar. Quando o argumento for usado, os recursos de cadeia de caracteres da localidade fornecida são extraídos como um arquivo .resx neutro. Se o auto ou apenas o formato longo ou abreviado do switch for especificado, a localidade base ou a solução serão usadas. Você pode usar o formato abreviado do comando: /src.

/localizar

Opcional. Extrair ou mesclar todos os recursos de cadeia de caracteres em arquivos .resx. Você pode usar o formato abreviado do comando: /loc.

Use o argumento de comando do /mapa

A seguinte discussão detalha o uso do argumento /map para a ferramenta SolutionPackager.

Os arquivos que são criados em um sistema de compilação automática, como os arquivos .xapSilverlight e assemblies do plug-in, geralmente não são verificados no controle de origem. Os recursos da Web podem já estar presentes no controle de código-fonte em locais que não são compatíveis diretamente com a ferramenta SolutionPackager. Incluindo o parâmetro /map, a ferramenta SolutionPackager pode ser direcionada para ler e empacotar tais arquivos a partir de locais alternados e não de dentro da pasta Extract como normalmente seria feito. O parâmetro /map deve especificar o nome e o caminho para um arquivo XML que contém diretrizes de mapeamento que instruem o SolutionPackager a combinar arquivos pelo nome e caminho, e indicar o local alternativo para localizar o arquivo correspondido. As seguintes informações se aplicam às políticas de forma igual.

  • Várias diretivas podem ser listadas, inclusive as que combinarão arquivos idênticos. Diretrizes listadas no início do arquivo têm prioridade sobre as listadas posteriormente.

  • Se o arquivo é combinado com qualquer diretiva, ele deve ser encontrado pelo menos em um local alternativo. Se não forem encontradas alternativas de combinação, o SolutionPackager emitirá um erro.

  • A pasta e os caminhos do arquivo podem ser absolutos ou relativos. Os caminhos relativos são sempre avaliados a partir da pasta especificada pelo parâmetro /folder.

  • Variáveis de ambiente podem ser especificadas usando uma sintaxe %variable%.

  • Um caractere curinga da pasta “**" pode ser usado para representar “em qualquer subpasta”. Só pode ser usado como parte final do caminho, por exemplo: “c:\folderA\**.

  • Os caracteres curingas do nome do arquivo podem ser usados somente nos formulários “*.ext” ou “*.*”. Nenhum outro padrão possui suporte.

Os três tipos de mapeamento de diretivas estão descritos aqui, juntamente com um exemplo que mostra como usá-los.

Mapeamento de pasta

A tabela a seguir apresenta informações detalhadas sobre o mapeamento de pasta.

Formato XML

<Folder map="folderA" to="folderB" />

Descrição

Os caminhos do arquivo que correspondem “folderA“ serão alterados para "folderB".

  • A hierarquia das subpastas em cada uma deve corresponder de forma exata.

  • Os caracteres curingas da pasta não possuem suporte.

  • Nenhum nome de arquivo pode ser especificado.

Exemplos

 
<Folder map="folderA" to="folderB" />
<Folder map="folderA\folderB" to="..\..\folderC\" />
<Folder map="WebResources\subFolder" to="%base%\WebResources" />

Mapeamento de arquivo a arquivo

A tabela a seguir apresenta informações detalhadas sobre o mapeamento de arquivo a arquivo.

Formato XML

<FileToFile map="path\filename.ext" to="path\filename.ext" />

Descrição

Qualquer arquivo que corresponda com o parâmetro map será lido a partir do nome e o caminho especificado no parâmetro to.

Para o parâmetro map:

  • Um nome do arquivo deve ser especificado. O caminho é opcional. Se nenhum caminho for especificado, os arquivos de qualquer pasta podem ser correspondidos.

  • Os caracteres curingas do nome do arquivo não possuem suporte.

  • O caractere curinga da pasta possui suporte.

Para o parâmetro to:

  • Um nome do arquivo e caminho devem ser especificados.

  • O nome do arquivo pode ser diferente do nome no parâmetro map.

  • Os caracteres curingas do nome do arquivo não possuem suporte.

  • O caractere curinga da pasta possui suporte.

Exemplos

 
<FileToFile map="assembly.dll" to="c:\path\folder\assembly.dll" />
<FileToFile map="PluginAssemblies\**\this.dll" to="..\..\Plugins\**\that.dll" />
<FileToFile map="Webresrouces\ardvark.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\aardvark.jpg" />

Mapeamento do arquivo ao caminho

A tabela a seguir apresenta informações detalhadas sobre o mapeamento do arquivo ao caminho.

Formato XML

<FileToPath map="path\filename.ext" to="path" />

Descrição

Qualquer arquivo que corresponda com o parâmetro map é lido a partir do caminho especificado no parâmetro to.

Para o parâmetro map:

  • Um nome do arquivo deve ser especificado. O caminho é opcional. Se nenhum caminho for especificado, os arquivos de qualquer pasta podem ser correspondidos.

  • Os caracteres curingas do nome do arquivo possuem suporte.

  • O caractere curinga da pasta possui suporte.

Para o parâmetro to:

  • É necessário especificar um caminho.

  • O caractere curinga da pasta possui suporte.

  • Um nome do arquivo não deve ser especificado.

Exemplos

 
<FileToPath map="assembly.dll" to="c:\path\folder" />
<FileToPath map="PluginAssemblies\**\this.dll" to="..\..\Plugins\bin\**" />
<FileToPath map="*.jpg" to="%SRCBASE%\CrmPackage\WebResources\JPG format\" />
<FileToPath map="*.*" to="..\..\%ARCH%\%TYPE%\drop" />

Mapeamento de exemplo

O seguinte exemplo do código XML mostra um arquivo de mapeamento completo que habilita a ferramenta SolutionPackager a ler qualquer recurso da Web e os dois assemblies gerados por padrão de um projeto Kit de Ferramentas para Desenvolvedores chamado CRMDevTookitSample.

<?xml version="1.0" encoding="utf-8"?>
<Mapping>
       <!-- Match specific named files to an alternate folder -->
       <FileToFile map="CRMDevTookitSamplePlugins.dll" to="..\..\Plugins\bin\**\CRMDevTookitSample.plugins.dll" />
       <FileToFile map="CRMDevTookitSampleWorkflow.dll" to="..\..\Workflow\bin\**\CRMDevTookitSample.Workflow.dll" />
       <!-- Match any file in and under WebResources to an alternate set of sub-folders -->
       <FileToPath map="WebResources\*.*" to="..\..\CrmPackage\WebResources\**" />
       <FileToPath map="WebResources\**\*.*" to="..\..\CrmPackage\WebResources\**" />
</Mapping>

Soluções gerenciadas e não gerenciadas

Um arquivo compacto Microsoft Dynamics 365 de solução (.zip) pode ser exportado em um dos dois tipos, conforme mostrado aqui.

  • Solução gerenciada
    Uma solução concluída pronta para ser importada a uma organização. Depois de importados, os componentes não podem ser adicionados ou removidos, embora possam opcionalmente permitir a personalização futura. Isso é recomendável quando o desenvolvimento da solução for concluída.
  • Solução não gerenciada
    Uma solução em aberto sem restrições em que pode ser adicionada, removida ou alterada. Isso é recomendável durante o desenvolvimento de uma solução.

O formato de um arquivo de solução compactado será diferente com base no seu tipo, gerenciado ou não gerenciado. O SolutionPackager pode processar arquivos de solução compactados de qualquer tipo. Entretanto, a ferramenta não pode converter um tipo para outro. A única maneira de converter arquivos de solução para um tipo diferente, por exemplo de não gerenciado para gerenciado, é importando o arquivo de solução não gerenciado .zip para um servidor Microsoft Dynamics 365 e depois exportar a solução como uma solução gerenciada.

O SolutionPackager pode processar arquivos de solução gerenciados e não gerenciados .zip como um conjunto combinado por meio do parâmetro /PackageType:Both. Para executar essa operação, é necessário exportar a sua solução duas vezes conforme cada tipo, nomeando os arquivos .zip conforme segue.

Arquivo .zip não gerenciado: AnyName.zip

Arquivo .zip gerenciado: AnyName_managed.zip

A ferramenta assumirá a presença de arquivo gerenciado zip na mesma pasta que o arquivo não gerenciado e extrairá ambos os arquivos em uma única pasta que preserva as diferenças onde existem os componentes gerenciados e não gerenciados.

Depois que uma solução foi extraída como gerenciada e não gerenciada, é possível, a partir de uma única pasta, empacotar as duas, ou cada tipo individualmente, usando o parâmetro /PackageType para especificar qual tipo criar. Ao especificar ambas, os dois arquivos .zip serão gerados, usando a convenção de nomenclatura conforme acima. Se o parâmetro /PackageType estiver ausente ao empacotar a partir de uma pasta gerenciada e não gerenciada, o padrão é gerar um único arquivo .zip não gerenciado.

Solução de Problemas

Se você usar Microsoft Visual Studio 2012 para editar os arquivos de recurso criados pelo fornecedor da solução, você pode receber uma mensagem ao reembalar de maneira semelhante a: “Falha para determinar o ID da versão do arquivo do recurso <filename>.resx o arquivo de recurso deve ser exportado na ferramenta solutionpackager.exe para ser usado como parte do processo do pacote.” Isso ocorre porque Visual Studio substitui as marcas dos metadados dos arquivos de recursos com as marcas de dados.

Solução alternativa

  1. Abra o arquivo de recurso no seu editor de texto favorito e localize e atualize as seguintes marcas:

    <data name="Source LCID" xml:space="preserve">
<data name="Source file" xml:space="preserve">
<data name="Source package type" xml:space="preserve">
<data name="SolutionPackager Version" mimetype="application/x-microsoft.net.object.binary.base64">

  2. Altere o nome do nó de <data> para <metadata>.

    Por exemplo, este segmento:

    <data name="Source LCID" xml:space="preserve">
  <value>1033</value>
</data>

    Alterações:

    <metadata name="Source LCID" xml:space="preserve">
  <value>1033</value>
</metadata>

Isso permite que o embalador da solução leia e importe o arquivo de recurso. Esse problema só foi observado ao usar o editor de recursos Visual Studio.

Confira Também

Ferramentas da solução para desenvolvimento da equipe
Usar o controle da fonte com arquivos de solução
Solution component file reference (SolutionPackager)
Introdução às soluções

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais