Usando Snippets de Código em

Conclusão do código e Fix-It pode tanto ajudá-lo a acelerar sua digitação e escrita do código Swift. Os fragmentos de código na biblioteca vão ainda mais longe: são trechos de código que você pode simplesmente arrastar para o seu próprio código. Você pode usar um snippet como está, mas muitos têm tokens - áreas destacadas que você pode personalizar com seus próprios nomes de variáveis ​​ou outras personalizações.

Quando você arrasta trechos com tokens em seu código, quase sempre geram erros porque você ainda não substituiu os tokens. Isto é normal.

Além da biblioteca embutida, você pode criar seus próprios fragmentos. Ambos os métodos são discutidos aqui.

Trabalhando com snippets de código incorporados

Aqui estão as etapas a serem usadas para trabalhar com trechos de código incorporados.

1. Se necessário, mostre a área de utilitários.

   As áreas de utilitários, navegadores e depuração podem ser exibidas ou ocultadas independentemente, então o que é visível depende do que você fez. O trio de botões no canto superior direito da barra de ferramentas permite mostrar ou esconder cada uma dessas áreas.

   Para tornar a área da biblioteca tão grande quanto possível, você pode querer arrastar a barra da guia, como mostrado.

   

2. Clique nos trechos na barra de guias.

3. Digite Swift no campo de pesquisa na parte inferior.

   A biblioteca contém fragmentos de vários idiomas, portanto, procurar Swift irá garantir que você esteja trabalhando apenas com os fragmentos Swift.

4. Selecione o snippet que você deseja usar.

   Informações sobre o snippet são mostradas.

5. Arraste o trecho para o seu código fonte e coloque-o onde quiser, como mostrado aqui.

   

   Se houver tokens no trecho, você pode receber mensagens de erro até inserir seus próprios dados.

   Além de substituir tokens, sinta-se livre para fazer outras alterações que você deseja para o código. Quando você largou um trecho no seu código, ele se torna parte do seu código. O fato de que ele veio de um trecho em vez de sua própria digitação não importa.

Criando seus próprios fragmentos de código

Você pode criar seus próprios fragmentos de código e adicioná-los à biblioteca. Você pode criá-los para qualquer código que você use habitualmente, desde avisos de direitos autorais até outras seções particularmente relevantes para o seu trabalho.

Veja como criar um snippet próprio:

1. Se necessário, mostre a área de utilitários.

   Para tornar a área da biblioteca tão grande quanto possível, você pode querer arrastar a barra da guia para cima.

2. Clique nos trechos na barra de guias.

3. Destaque o código que deseja criar como um snippet e arraste-o para a biblioteca, como mostrado aqui.

   

   Observe que a figura mostra o código de uma das funções no modelo que está sendo arrastado para a biblioteca: É por isso que você pode ver o código no arquivo, bem como o código no processo de arrastar.

4. Selecione o snippet na biblioteca.

   Informações sobre o snippet são mostradas.

5. Clique no botão Editar na parte inferior esquerda, como mostrado.

   

6. Adicione um bom título para o snippet e, a menos que o fragmento que você está criando for independente do idioma, como um aviso de direitos autorais, altere a configuração de idioma para Swift.

7. Escolha um escopo no menu pop-up do Escopo de Conclusão.

   

   A adição de um escopo torna seus trechos ainda mais úteis porque ele impede (ou seus colegas) de adicionar o snippet em locais ilógicos.

   Defina a configuração de idioma antes de escolher o escopo de conclusão. As opções de escopo de conclusão no menu pop-up variam de acordo com o idioma selecionado.

8. (Opcional) Substitua o texto do token, como o mostrado.

   

   O texto Token pode ser mais do que uma palavra. Até que o token seja substituído, seu snippet gerará um erro - novamente, isso é normal.

   A figura a seguir mostra um snippet personalizado com um token (e os erros associados).