Jump to content
MuddyShadows

Compilando o Hercules com Cygwin

Recommended Posts

Este tutorial foi escrito no dia 21/01/2020. Até o momento, esse método se mostra funcional e compila o Hercules perfeitamente.

 

Ao começar a mexer com desenvolvimento de Ragnarok, uma das primeiras barreiras que muitas pessoas encontram aparece na hora de compilar o emulador. Este guia é para aqueles que não querem instalar o Visual Studio, ou que não querem fazer dual boot com uma distribuição GNU/Linux.

 

Índice

  1. O que é Cygwin?
  2. Baixando
  3. Instalando
  4. Compilando o Hercules

 

1. O que é Cygwin?

 

Colocando de forma simples, Cygwin é um conjunto de ferramentas que você normalmente encontraria em uma distribuição GNU/Linux, só que no Windows. Diferente do Visual Studio, com seu tamanho medido em gigabytes, essas ferramentas são pequenas e vão tornar a tarefa de compilar o Hercules algo bem mais prático.

 

Vantagens

  • Rápido e fácil de usar.

 

Desvantagens

  • Não compila tão rápido quanto no Visual Studio;
  • Gera binários (*.exe) dependentes das DLLs do Cygwin, ou seja, você não poderá executar seu emulador em outro computador caso ele não possua todas as DLLs necessárias.

 

2. Baixando

 

Acesse o site do Cygwin e escolha um instalador compatível com a arquitetura de seu sistema operacional. No meu caso, usarei o setup-x86.exe.

 

Não sabe qual instalador baixar? Leia: Como saber se o meu Windows é 32 ou 64 bits?

 

3. Instalando

 

Abra o instalador. Você deve se deparar com uma tela parecida com esta. Clique em "Next".

 

1.png

 

Nesta janela iremos escolher como instalar o Cygwin. Escolha a primeira opção caso nunca tenha instalado o programa antes.

 

Install from Internet

Nessa opção, o programa vai baixar tudo que precisa e guardar os arquivos em uma pasta de sua escolha para uso futuro. Isso inclui todos os pacotes que o Cygwin irá baixar mais para frente.

 

Download without Installing

Escolha essa opção caso deseje baixar os pacotes sem instalar nada agora.

 

Install from Local Directory

Escolha essa opção para usar os arquivos salvos pela primeira opção. Basicamente, serve para caso você precise reinstalar o Cygwin e ainda tenha a pasta com os pacotes salvos ao selecionar a primeira versão. É uma opção interessante para instalar o programa em outros computadores com todos os pacotes que você baixou.

 

Clique em "Next" para prosseguir.

 

2.png

 

Agora, vamos escolher onde o programa será instalado. Recomendo que mantenha a raíz do C:/ como opção para evitar problemas desnecessários. Clique em "Next" para prosseguir.

 

3.png

 

Escolha onde salvar os arquivos de instalação. Pode escolher qualquer diretório, estes arquivos podem ser deletados no fim do processo caso você não queira guardá-los.

 "Next".

4.png

 

Não recomendo que mexa nestas opções caso não saiba o que está fazendo. Apenas deixe "Use system proxy settings" marcado e siga adiante.

 

5.png

 

Essa parte é importante. Nesta janela iremos indicar para o programa o repositório que ele consultará para baixar todos os pacotes que precisamos.

 

Eu uso este repositório: http://mirrors.kernel.org/sourceware/cygwin/

Caso prefira escolher outro, dê uma olhada nessa lista: Cygwin Mirror Sites

 

  1. Copie e cole o link do repositório na janela "User URL" e clique em "Add";
  2. Selecione o repositório que você adicionou na aba "Available download sites";
  3. "Next".

 

6.png

 

Aguarde um pouco até o instalador terminar de baixar alguns arquivos. Você deve ver uma janela em branco como esta abaixo. No canto superior esquerdo, clique na caixa "Pending" e troque para "Full".

 

7.png

 

8.png

 

É nessa etapa que iremos selecionar tudo que o Hercules precisa para compilar sem problemas. Use a caixa "Search" para procurar pelo nome do pacote.

 

Lista de pacotes:

  • git
  • gcc
  • make
  • mysql-devel
  • zlib-devel
  • libpcre-devel

 

Na aba "New", troque a opção de "Skip" para a versão mais recente de cada pacote. No meu caso, as opções "Keep" e "Uninstall" aparecem pois eu já tenho os pacotes instalados. Caso você não tenha, as opções serão apenas as versões do programa selecionado.

 

9.png

 

10.png

 

11.png

 

12.png

 

13.png

 

14.png

 

Com tudo selecionado, prossiga clicando em "Next".

 

Estamos no final da instalação. Aqui, uma lista com tudo que será baixado e instalado aparecerá. Apenas siga em frente e aguarde. Essa etapa irá demorar um pouco.

 

15.png

 

Por fim, clique em "Finish" para concluir a instalação. Crie um ícone no desktop se quiser.

 

16.png

 

Seu Cygwin já está instalado e funcionando, mas ainda precisamos fazer mais uma coisa: Adicionar as DLLs do Cygwin no PATH do sistema.

 

Abra o seu Menu Iniciar e escreva "Editar variáveis de ambiente do sistema". Se não aparecer nada, procure apenas por "ambiente", ou "var".

 

20.png

 

Ao clicar na opção acima, uma janela parecida com esta deve abrir. Clique em "Variáveis de ambiente...".

 

21.png

 

Agora, scrolle um pouco a caixa dentro da categoria "Variáveis do sistema". Encontre a variável PATH e clique em editar.

 

22.png

 

Uma nova janela irá abrir. Coloque um ponto e vírgula ";" no final da linha caso não tenha, e em seguida escreva "C:\cygwin\bin" sem as aspas na caixinha. Dê OK em tudo para confirmar a mudança.

 

23.png

 

Atenção: Caso esteja usando o Windows 10, o processo é um pouco diferente. Leia este artigo: Add to the PATH on Windows 10

 

4. Compilando o Hercules

 

Caso você nunca tenha tido contato com um terminal bash antes, recomendo que leia este artigo e se familiarize com alguns comandos básicos. É tudo coisa simples, indico a leitura apenas para facilitar a vida de alguns: 10 Comandos Essenciais do Linux

 

Abra o terminal do Cygwin. Você pode encontrar um ícone no Menu Iniciar, ou usar o ícone no seu desktop caso você tenha marcado a opção no fim da instalação.

 

Atenção: Ao digitar os comandos, NÃO digite o "$" (cifrão). Este ícone está aí para representar o prompt do terminal. Digite apenas os comandos.

 

Se tudo estiver certo, uma tela preta irá abrir com algo parecido com isto:

[email protected] ~
$

Escreva:

$ git init hercules

A mensagem "Initialized empty Git repository in /home/username/hercules/.git/" irá aparecer logo em seguida. Agora, digite:

$ cd hercules
$ git remote add origin https://github.com/HerculesWS/Hercules.git
$ git pull origin stable

Ao digitar o último comando, o git irá importar o repositório do Hercules para sua pasta. Esse processo demora um pouco mesmo, apenas tenha paciência. Por fim, digite:

$ clear
$ ls

Seu terminal deve estar mais ou menos assim:

 

17.png

 

Agora, vamos começar a compilar o emulador propriamente dito.

 

Escreva:

$ ./configure

Lembre-se: não escreva o cifrão, apenas o comando. Ele começa com um ponto mesmo.

 

Aguarde o processo terminar. Se essa etapa falhar, significa que seu Cygwin não está com todos os pacotes necessários, ou que talvez esteja com uma versão incorreta de um ou mais pacotes.

 

18.png

 

Digite:

$ make clean && make sql

 

Se tudo der certo, seu emulador irá compilar sem problemas. É isto, fim.

 

19.png

 

Atenção: No momento, você possui apenas um emulador compilado, nada mais. Você ainda precisa configurar os arquivos necessários da pasta "/conf", configurar uma database SQL, e depois preparar a pasta do seu cliente com um hexed diffado e todos os outros arquivos necessários para que tenha um servidor funcional.

 

A pasta do seu emulador deve estar em "C:\cygwin\home\username\hercules". Se quiser, pode tirar ela daí e jogar onde achar melhor, mas sempre que for compilar/recompilar o emulador, você deve colocá-lo nesse mesmo diretório.

 

Como atualizar o meu Hercules para a versão mais recente?

Digite dentro da pasta do emulador:

$ git pull origin stable

 

Como recompilar o Hercules?

Digite:

$ make sql

Se preferir limpar a pasta e compilar tudo de novo, digite:

$ make clean && make sql

 

Edited by MuddyShadows

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...

×
×
  • Create New...

Important Information

By using this site, you agree to our Terms of Use.