Tradução: Documentação PlayOnLinux:

aprendinolinux
(usa Ubuntu)

Enviado em 31/12/2014 - 12:13h

http://www.playonlinux.com/en/documentation.html

Criar um script para PlayOnLinux - Capítulo 1: Conhecendo Bash

Introdução

Você gostaria de criar seus próprios scripts para PlayOnLinux, mas você não sabe nada sobre programação?
Este tutorial vai explicar o básico e em breve você vai ser um profissional em Bash playonlinuxian.

PlayOnLinux tem funções avançadas em Bash para tornar o processo mais fácil para escrever scriptis. Vamos nos familiarizar com eles.

Bash?

O Bash é um intérpretador de comando (ou "shell") em GNU/Linux e Mac OS X.
É o que aparece quando você entra em um terminal.
Ele também permite que você faça scripts.
Um script é uma lista de comandos que o seu shell irá executar um após o outro.

Requisitos mínimos necessários para cada script

Cada script em PlayOnLinux deve conter pelo menos este código:

#!/bin/bash

[ "$PLAYONLINUX" = "" ] && exit 0

source "$PLAYONLINUX/lib/sources"
 
POL_SetupWindow_Init
 
POL_SetupWindow_Close
exit

 

O código acima pode não fazer sentido para você ainda.
Vamos explicar o que ele faz à medida que avançamos neste tutorial.

Durante este tutorial, não vou repetir este código, mas nos exemplos, quando for necessário, irá ver este códio ou algo similar.
Lembre-se de incluí-lo sempre em seus scripts ou não vai funcionar.

Executando o script

Use seu editor de texto favorito para salvar seu script, em seguida, use a função de executar um script local a partir do menu Ferramentas do PlayOnLinux.

Assinatura de Scripts

PlayOnLinux usa uma assinatura digital (autenticação) em scripts para certificar que os scripts foram validados por scripters PlayOnLinux.
Todos os scripts disponíveis na janela de instalação do PlayOnLinux já foram validados.

Cada vez que você vai tentar executar um script que não foi validado por scripters PlayOnLinux, você receberá uma mensagem de aviso informando que o script não tem nenhuma assinatura válida
(ver imagem abaixo).

http://www.playonlinux.com/doc/images/ch01-01.en.png

Você deve clicar no botão Next (Avançar) para que seja mostrado a origem do script em PlayOnLinux, em seguida, clique na caixa de seleção Concordo, antes e você poderá (finalmente) executar o script
(ver screeshot abaixo).
http://www.playonlinux.com/doc/images/ch01-02.en.png

Próximo capítulo.


ps: Esta tradução está sendo preparada para compor o site principal de PlayOnLinux em: http://www.playonlinux.com/en/dev-documentation-1.html versão pt_br Se você encontrar erros ou puder merolha-la, responda neste fórum.

aprendinolinux
(usa Ubuntu)

Enviado em 31/12/2014 - 20:12h

Criar um script para PlayOnLinux - Capítulo 2: Funções básicas

Vamos ver alguns comandos básicos para escrever scripts em PlayOnLinux.

Nota: todos os comandos que estamos prestes a ver devem ser inseridos entre o POL_SetupWindow_Init e os comandos POL_SetupWindow_Close.

Exibição de uma mensagem

Aí vem o POL_SetupWindow_message comando:
Sintaxe:

POL_SetupWindow_message "Message" "Window title"
 

Exemplo:

#!/bin/bash
[ "$PLAYONLINUX" = "" ] && exit 0
source "$PLAYONLINUX/lib/sources"
 
POL_SetupWindow_Init
 
POL_SetupWindow_message "Hello World!" "My first message"
 
POL_SetupWindow_Close
exit
 

Isto é o que você vai ver:
http://www.playonlinux.com/doc/images/ch02-01.en.png
Agora você pode exibir uma mensagem.
Feliz?

Uma zona de texto

Você quer perguntar algo para o usuário?
A função POL_SetupWindow_textbox foi criada para esta finalidade.
Adicione o seguinte código ao seu script:
Sintaxe:

POL_SetupWindow_textbox "Mensagem" "Título da janela"
 

Exemplo:

POL_SetupWindow_textbox "Quem é o seu nome?" "Zona de Texto"
 

http://www.playonlinux.com/doc/images/ch02-02.en.png
Vamos ver no próximo capítulo como recuperar o texto que o usuário digitou.
Uma pergunta?

Você quer que o usuário resposta sim ou não?
Em seguida, use esta função POL_SetupWindow_question
Sintaxe:

POL_SetupWindow_question "Pergunta" "Título da janela"  
 

http://www.playonlinux.com/doc/images/ch02-03.en.png
No próximo capítulo veremos como recuperar a resposta para uma pergunta.

Um pequeno menu

Assim como para as duas funções anteriores, você pode criar um menu para PlayOnLinux.
Sintaxe:

POL_SetupWindow_menu "Mensagem" "título na janela" "Opções disponíveis separados com o separador" "O separador" 
 

Explicações:

As diferentes entradas devem ser separadas por um único separador de caráter, que é fornecido como o próximo argumento, os personagens mais frequentemente utilizados para isso são o traço (-), e Tilda (~).
Exemplo:

POL_SetupWindow_menu "O que você gostaria de comer hoje à noite?"  "Menu de opções" "Cenouras | Batatas | batatas-fritas" "|" 
 

http://www.playonlinux.com/doc/images/ch02-04.en.png
No próximo capítulo veremos como recuperar a entrada selecionada.
Selecione um arquivo

Você pode perguntar ao usuário o que ele deseja selecionar em seu computador.
Por exemplo, pode ser um arquivo.
Sintaxe:

POL_SetupWindow_browse "Mensagem" "Título na janela" 
 

Exemplo:

POL_SetupWindow_browse "Selecionar o programa de instalação" "Escolha o arquivo" 
 

http://www.playonlinux.com/doc/images/ch02-05.en.png
No próximo capítulo veremos como recuperar o arquivo escolhido.
Apresentando seu aplicativo

Este comando é muito importante.
Ele permite que você possa introduzir um aplicativo para o usuário antes que ele vá para a instalação.
Sintaxe:

POL_SetupWindow_presentation "Nome do programa" "editor do programa" "local do Editor" "seu pseudo" "prefixo do Programa (ver capítulo 5)"
 

Exemplo:

POL_SetupWindow_presentation "Mozilla Firefox" "Mozilla" "http://www.mozilla.com" "autor Script" "MozillaFirefox"
 

http://www.playonlinux.com/doc/images/ch02-06.en.png
Comente seu código

O símbolo "#" indica ao Bash para ignorar o texto até o fim da linha.
Aqui está um exemplo:

POL_SetupWindow_message "Olá" "Test"
 # Um bom comentário
 POL_SetupWindow_message "Goodbye" "Test" 
 

Você deve comentar seus scripts, tanto quanto possível para melhorar a sua capacidade de leitura e ajudar scripters na sua tarefa de validação.

<<< Capítulo anterior - Próximo capítulo>>>

ps: Esta tradução está sendo preparada para compor o site principal de PlayOnLinux em: http://www.playonlinux.com/en/dev-documentation-2.html versão pt_br Se você encontrar erros ou puder merolha-la, responda neste fórum.

aprendinolinux
(usa Ubuntu)

Enviado em 02/01/2015 - 12:12h

Variável? É um novo insulto?

Não, não é um insulto.
A variável é um elemento muito importante na programação.
É definido por um nome e um valor.
Esse valor pode variar ao longo do script.

Se você não entender, continue lendo e você vai descobrir o que é tudo sobre.
Declarando uma variável

  MY_VARIABLE = "My valor" 
 

Leitura de uma variável

Você tem que colocar este sinal "$" na frente da variável.

Aqui está um exemplo de código:

 FRUIT = "pera"

 POL_SetupWindow_message "Eu gosto de comer um $ fruta" "A minha fruta favorita" 
 

http://www.playonlinux.com/doc/images/ch03-01.en.png
Você pode usar variáveis &#8203;&#8203;em qualquer mensagem, menu, etc.
POL_SetupWindow_menu e variáveis

Você se lembra esse código?

  POL_SetupWindow_menu "O que você quer comer hoje à noite?"  "Menu Tonight" "Cenouras Batatas batatas-fritas" "" 
 

O resultado é, na verdade enviado para a variável $ APP_ANSWER. Este é o caminho para recuperar escolha do usuário:

  POL_SetupWindow_menu "O que você quer comer hoje à noite?"  "Menu Tonight" "Cenouras Batatas batatas-fritas" ""

 POL_SetupWindow_message "Hoje à noite vamos estar comendo $ APP_ANSWER, uma escolha muito boa."  "Menu Tonight" 
 

POL_SetupWindow_browse e variáveis

Para POL_SetupWindow_browse, é o caminho para o arquivo selecionado pelo usuário que está armazenado em $ APP_ANSWER.
POL_SetupWindow_question e variáveis

Para POL_SetupWindow_question, $ APP_ANSWER conterá TRUE se o usuário respondeu sim, e FALSE se ele(a) usuário respondeu não.

<<<Capítulo anterior - Próximo capítulo>>>>

ps: Esta tradução está sendo preparada para compor o site principal de PlayOnLinux em: http://www.playonlinux.com/en/dev-documentation-3.html versão pt_br Se você encontrar erros ou puder merolha-la, responda neste fórum.