Minigui - Como começar - em Português

MINIGUI - Como Começar - Links para Downloads

Requirementos:

Para instalar e usar a MiniGUI Extended, você precisará:
- Do compilador (The Borland BCC compiler (version 5.5.1) )
- Dos binários (executável) do Harbour (ou xHarbour)
- Do código fonte e binários da MiniGUI extended

Instalação:
1. Faça o Download do Borland BCC free (grátis) de:
http://www.hmgextended.com/files/MISC/FreeCommandLineTools.exe
e instale na pasta: C:\BORLAND\BCC55

NOTA: Se você instalar este compilador (e Harbour e MiniGUI) em outro drive, veja o Passo #8 abaixo.

2. Edite (ou crie) C:\BORLAND\BCC55\Bin\bcc32.cfg e inclua as seguintes linhas:
-I"c:\Borland\Bcc55\include"-L"c:\Borland\Bcc55\lib;c:\Borland\Bcc55\lib\psdk"

NOTA PARA USUÁRIOS DO xHARBOUR: Se você está instalando para xHarbour, você deve ao invés incluir as seguintes linhas:

-I"c:\Borland\Bcc55\include;c:\xharbour\include"
-L"c:\Borland\Bcc55\lib;c:\Borland\Bcc55\lib\psdk;c:\xharbour\lib"

3. Edite (ou crie) C:\BORLAND\BCC55\Bin\ilink32.cfg e inclua as seguintes linhas:

-L"c:\Borland\Bcc55\lib;c:\Borland\Bcc55\lib\psdk"

NOTA PARA USUÁRIOS DO xHARBOUR: Se você está instalando para xHarbour, você deve ao invés incluir as seguintes linhas:

-L"c:\Borland\Bcc55\lib;c:\Borland\Bcc55\lib\psdk;c:\xharbour\lib"

4. Faça o Download dos binários do compilador Harbour (ou xHarbour) (Integrated Build) de:
http://www.hmgextended.com/files/HARBOUR
ou
http://www.hmgextended.com/files/xHARBOUR
e instale na pasta C:\HARBOUR (ou C:\xHARBOUR) seguindo as diretivas do Setup Wizard.

NOTA: Existem significantes diferenças entre os binários do Harbour e xHarbour !
JF: A pasta HARBOUR contêm 3 arquivos: "Build 47", "Devel Build 1.1", e "Devel Build 1.1-1". A pasta xHARBOUR contêm 6 arquivos (Grigory's build, e compilação Lasse's, para as versões 0.99.60 e 0.99.70, mais um arquivo para cada 1.0.0 Beta e 1.1.0 Beta). Do que advêm a pergunta de qual instalar?
JF: Eu acredito que deveria ser de muito auxílio incluir um sumário de alguém que é familiar com Harbour e xHarbour, descrevendo as vantagens/desvantagens de cada plataforma para os desenvolvedores de HMGx.

5. Faça o Download dos (Fontes e Binários) da MiniGUI Extended de:
http://www.hmgextended.com/files/CONTRIB
(procure por aquivos tais como hmg-XX-setup.zip, onde XX é o número da versão).

NOTA: O conteúdos dos arquivos ZIP não podem ser extraídos usando WinZip. Você deve usar outro extrator de ZIP tal como WinRAR (http://www.rarlab.com) ou 7Zip (http://www.7-zip.org)

6. Clique em hmg-XX-setup.exe para instalar MiniGUI na pasta C:\MINIGUI seguindo as diretivas do Setup Wizard.

7. Faça o Download do arquivo:
http://tech.groups.yahoo.com/group/harbourminigui/files/CONTRIB/MakeBatch.zip
e descompacte (unzip) o arquivo batch "MakeLib" atualizado em in C:\MINIGUI

8. Se você instalou os arquivos acima em outro drive, mude todas as referencias para c:\ em:
BORLAND\BCC55\Bin\*.cfg MINIGUI\SOURCE\*.bat MINIGUI\SAMPLES\*.bat

9. Se você esta usando xHarbour, adicione a seguinte linha no AUTOEXEC.NT:

SET MG_CMP=XHARBOUR

10. Clique em \MINIGUI\SOURCE\MakeAllLibs.bat para gerar todas as libraries na pasta \MINIGUI\SOURCE e subpastas. Isto inclui as libraries do Harbour e da MiniGUI.

NOTA PARA USUÁRIOS DO xHARBOUR: Este arquivo batch cria as seguintes libraries em \xHARBOUR\lib (estes estavam anteriormente em \MINIGUI\xlib):ADORDD (na ordem para criar esta library, você deve copiar \MINIGUI\SOURCE\adordd\adordd.ch para a pasta \xHARBOUR\include)
CALLDLL
DLL
HBCOMM
HBPRINTER
HBSQLLITE3
HBXML
MINIPRINT
SHELL32
SOCKETT
MSAGENT

NOTA PARA USUÁRIOS DO xHARBOUR: Se você está usando o xHarbour, as seguintes libraries NÃO PODEM ser criadas:
JF: Esta lista deve ser completada

HBOLE.LIB: Esta library não é necessária com xHarbour
JF: Consideração sobre HBCOMM: Como em 8-01-2008 Lasse Holm reportou "retenham os antigos arquivos make_b32.bat e hbcomm.bc, Eu entendo que o Grigory irá fazer uma pequena modificação para eles, mas como estão agora os antigos funcionam"

NOTA PARA USUÁRIOS DO xHARBOUR: Arquivos de instalação para usuários que desejem usar xHarbour também estão disponíveis no Finnish xHarbour portal mantido por Lasse Holm:
http://www.the-holms.org/xharbour
Se você fizer o download dos arquivos de instalação do Finnish site, você deve ler as descrições dos arquivos para certificar-se que fez o download da versão da HMGx que corresponde a versão do xHarbour que você está usando.

11. Você pode encontrar exemplos de introdução ao trabalho com código MiniGUI em:
\MINIGUI\SAMPLES\BASIC \MINIGUI\SAMPLES\ADVANCED \MINIGUI\SAMPLES\APPLICATIONS

Clique \MINIGUI\SAMPLES\CompileAll.bat para gerar os arquivos de exemplo em MiniGUI.

NOTA PARA USUÁRIOS DO xHARBOUR: Se você está usando xHarbour, você deve mudar as referências de ziparchive.lib em \MINIGUI\BATCH\Compile.bat para hbzip.lib

NOTA PARA USUÁRIOS DO xHARBOUR: Quando gerar algum dos exemplos, usuários do xHarbour irão receber mensagens de erro se referindo a função faltante HB_FUN_CALLDLL. Este erro pode ser corrigido modificando o arquivo \MINIGUI\BATCH\Compile.bat. Sobre o label :XRSPREST insira a seguinte linha, antes da linha contendo libmisc.lib
echo %MV_HRB%\lib\dll.lib + >> _temp.rsp

NOTA PARA USUÁRIOS DO xHARBOUR: Se você não puder encontrar a DLL.LIB em \xHARBOUR\lib, copie esta library de: \MINIGUI\Lib or \MINIGUI\xlib

NOTA PARA USUÁRIOS DO xHARBOUR: O arquivo \MINIGUI\BATCH\Compile.bat contêm diferenças sobre os labels :HRSPREST e :XRSPREST. A diferença está aonde HBPRINTER.LIB, MINIPRINT.LIB, e SOCKET.LIB são esperadas para serem encontradas (sobre um label, elas são esperadas em \xHARBOUR\lib, e sobre o outro, elas são esperadas em \MINIGUI\Lib ou \MINIGUI\xlib.
JF: Como em 7-01-2008 Kevin Carmody está pesquisando sobre esta diferença.

Exemplos adicionais e arquivos de ajuda podem ser encontrados em:

http://groups.yahoo.com/group/harbourminigui/files/
http://www.hmgextended.com/files/

Licença MiniGUI:

Harbour MiniGUI (e MiniGUI Extended) tem a mesma licença como o projeto Harbour. Assim se você linkar a library Harbour Minigui com outros arquivos para produzir um executável, isto não fará com que o executável resultante seja coberto pela GNU General Public License. Seu uso daquele executável não está de maneira alguma restrito a linkagem do código da library Harbour Minigui.

Traduzido por: Marcelo Brigatti