BUILD AND INSTALLATION


WIN32 Package - Instalação

  • Primeiro extraia wswinXXX-X.zip, então execute o setup.exe sob o diretório "wsinst".

  • Se houver a escolha por uma versão com Perl, Ruby ou Python, então o processo de instalação pode levar um tempo maior.
          Se escolhida a versão Java, instale antes JDK1.4.2 da Sun Microssystems, e ajuste as variáveis de ambiente através do diálogo de configuração do projeto no Builder.
  • Reinicie a máquina ao término da instalação.


MacOS X 10.3 Package - Instalação


Faça o download do "MacOS X 10.3 package".

gcc/g++/make devem ser instalados a partir de  ADC first, então instale o pacote conforme segue:
  • Download ws-v3.80-6-macosx.pkg.tar.gz
  • Double-click ws-v3.80-6-macosx.pkg para iniciar a instalação
  • Inicie o servidor X uma vez antes de reiniciar a máquina.
Se escolhida a versão Java, então instale "JDK1.4.2 Update2".


WideStudio para T-Engine - Instalação

Pode-se desenvolver aplicações para T-Engine utilizando-se "WideStudio for T-Engine WideStudio" em ambiente Linux que geram os binários T-Engine.

Consulte  WideStudio for T-Engine Installation sobre informações a respeito de configuração e ajustes do WideStudio para T-Engine.
Nota: Se estiver utilizando a versão v3.60-2, crie o diretório "lib-btron" sob o diretório "ws" antes de gerar executáveis (compilação/linkagem).

WideStudio para BTRON - Instalação


WideStudio para BTRON possibilita criar aplicações que executam em ambientes BTRON(Cho-Kanji) sob plataformas Linux, onde são gerados os binários para BTRON.
Consulte  WideStudio for BTRON Installation sobre informações a respeito de configuração e ajustes do WideStudio para T-Engine.
Nota: Se estiver utilizando a versão v3.60-2, crie o diretório "lib-btron" sob o diretório "ws" antes de gerar executáveis (compilação/linkagem).


Getting source code for Linux/FreeBSD/Solaris/MacOSX

Obtenha o código-fonte do WideStudio. Os arquivos poderão ser extraídos manualmente ou pelo seguinte procedimento:
Nota: vX.XX.X denota o número da versão.
  • Linux:
    cd /tmp
    tar -zsxvf ws-vX.XX.X-src.tar.gz
    cd /tmp/ws
  • SOLARIS:
    cd /tmp
    gzip -cd ws-vX.XX.X-src.tar.gz | tar -moxvf -

  • FreeBSD/MacOSX:
    cd /tmp
    tar -zsxvf ws-vX.XX.X-src.tar.gz
    cd /tmp/ws


WideStudio Build/Instalação

Siga o procedimento a seguir para gerar os executáveis de "WideStudio Target includes runtime libraries" e depurá-las.
Normalmente utiliza-se "Runtime libraries" (bibliotecas de execução). A depuração de bibliotecas é praticada durante a depuração de aplicativos durante o seu desenvolvimento.
Nós recomendamos veementemente compilar e linkar todos os componentes antes de iniciar o desenvolvimento.
Nota:
   - "ws" indica o diretório para onde o código-fonte é extraído.
   - Se estiver utilizando um pacote binário, será necessário compilar/linkar o WideStudio.
   - Por alguma razão, tal como configuração de ambiente do seu computador, poderá ocorrer a geração de mensagens de erro após a compilação. Em tais casos, execute "configure" e edit "sys/config/mkflags" para ajustar seu ambiente quanto aos caminhos (paths) e "link libraries".
  • ilding All Components
    cd ws/src
    ./configure
    make
  • Building Runtime Libraries Only
    cd ws/src
    ./configure
    make runtime
  • Building Debugging Libraries Only
cd ws/src
./configure
make debug

  • Compilando/linkando Java MPFC
Configure o diretório de instalação do JDK para a variável de ambiente JAVA_HOME antes de gerar executáveis.

cd ws/src
make java

  • Certifique-se que a aplicação geradora de executáveis (Application Builder, ws/bin/wsbuilder) esteja instalada depois que a geração de executáveis estiver terminada, e depois siga os procedimentos abaixo como "root":

  • make install
    Normalmente, a instalação é feita sob /usr/local/ws no Linux, e /opt/ws no Solaris.


Linux Frame Buffer Runtime Library Build/Instalação

Siga o procedimento abaixo para gerar os executáveis no Linux do "Frame Buffer Runtime Library".
Nota:
  - "ws" indica o diretório para onde o código-fonte é extraído.
   - Por alguma razão, tal como configuração de ambiente do seu computador, poderá ocorrer a geração de mensagens de erro após a compilação. Em tais casos, execute "configure" e edit "sys/config/mkflags" para ajustar seu ambiente quanto aos caminhos (paths) e "link libraries".
  • Linux Frame Buffer Runtime Library Build
    cd ws/src
    ./configure
    make devfb
  • Depois de compilado e linkado, como root, proceda: 
    make install
    Normalmente, instala-se no Linux sob o diretório /usr/local/ws. O nome da biblioteca é "libwsdevfb.so.x.xx", onde x.xx indica o número de versão.


Linux DirectFB Runtime Library Build/Instalação

Siga os passos abaixo para instalar a versão Linux da "Direct FB Runtime Library".

Nota:
  - "ws" indica o diretório para onde o código-fonte é extraído.
   - Por alguma razão, tal como configuração de ambiente do seu computador, poderá ocorrer a geração de mensagens de erro após a compilação. Em tais casos, execute "configure" e edit "sys/config/mkflags" para ajustar seu ambiente quanto aos caminhos (paths) e "link libraries".
  • Linux DirectFB Runtime Library Build
    cd ws/src
    ./configure
    make directfb
  • Depois de compilado e linkado, como root, proceda:
  • make install
    Normalmente, instala-se no Linux sob o diretório /usr/local/ws. O nome da biblioteca é "libwsdfb.so.x.xx", onde x.xx indica o número de versão.



mu-CLinux Frame Buffer Runtime Library Build/Instalação

Siga os passos abaixo para compilar/linkar "mu-CLinux Frame Buffer Runtime Library".
Primeiro, obtenha um compilador para a plataforma de trabalho, instalando-o. Por exemplo, se for um Fujitsu FRV-400, instale o compilador sob o diretório  /usr/local/frv-040611-4.

Nota:
  - "ws" indica o diretório para onde o código-fonte é extraído.
   - Por alguma razão, tal como configuração de ambiente do seu computador, poderá ocorrer a geração de mensagens de erro após a compilação. Em tais casos, execute "configure" e edit "sys/config/mkflags" para ajustar seu ambiente quanto aos caminhos (paths) e "link libraries".

  • mu-CLinux Frame Buffer Runtime Library Build (examplo FRV-400)
    cd ws/src
    ./configure
    make uclinux-frv
  • Depois de compilado e linkado, como root, proceda: 
    make install
    Normalmente, instala-se sob o diretório /usr/local/ws. sendo que o nome da biblioteca é libwsdevfb.a.


SHARP ZAURUS(Emblix Linux) Runtime Library Build/Instalação

Siga os procedimentos abaixo para compilar/linkar "ZAURUS (Emblix Linux) Runtime Library".

Primeiro, obtenha o compilador ZAURUS da SHARP Co.

Nota:
  - "ws" indica o diretório para onde o código-fonte é extraído.
   - Por alguma razão, tal como configuração de ambiente do seu computador, poderá ocorrer a geração de mensagens de erro após a compilação. Em tais casos, execute "configure" e edit "sys/config/mkflags" para ajustar seu ambiente quanto aos caminhos (paths) e "link library".
  • SHARP ZAURUS Runtime Library Build
    cd ws/src
    ./configure
    make zaurus
  • Depois de compilado e linkado, como root, proceda: 
    make install
  • Normalmente, instala-se sob o diretório /usr/local/ws. sendo que o nome da biblioteca é libwsdevfb.so.x.xx , sendo que x.xx indica o número de versão.

Troubleshooting (Solução de Problemas) para Build/Instalação

  • X11 header could not find error in compilation time
    Edite ws/sys/config/mkflags e altere XINCS, XLIBS values
  • jpg header could not find error in jpg.so building
    Verifique o local de instalação do header jpg e altere INCJPG, LIBJPG in ws/sys/config/mkflags
  • XPM header could not find error in building xpm.so
    Verifique o local de instalação do header XPM e altere INCXPM, LIBXPM in ws/sys/config/mkflags

Linux Runtime RPM Package Installation

Não necessidade de ajustar variáveis de ambientes quando utiliza-se pacotes RPM.
  • Instalação:
        su (chage to super user account)
        rpm -i --nodeps ws-runtime-vXXX.i386.rpm
  • Desinstalação:
        su (chage to super user account)
        rpm -e ws
Instala-se sob o caminho (path) "/usr/local/ws".

Nota:
   - Este pacote não inclue o código-fonte. Se desejar compilar/linkar o código-fonte, faça o download do fonte separadamente.
   - O pacote RPM não inclui a biblioteca para depuração.

AVISO:
Quando a versão de "libstdc++" é diferente daquela requirida, ocorrendo também a mensagem de erro "libstdc++-libc6.1-1.so.2 could not be found" (... não encontrada), então tente ajustar os link simbólicos a partir do diretório "/usr/lib/libstdc++.so.XX" para  "libstdc++-libc6.1-1.so.2 ".


WideStudio Configuration

A configuração seguinte necessita utilizar o WideStudio
WSDIR Especifica o local de instalação.
PATH Inclua WideStudio command path
LD_LIBRARY_PATH Inclua o caminho da biblioteca dinâmica do WideStudio (WideStudio dynamic link library)

Default WSDIR is set as the following
System Default
Linux /usr/local/ws/
SOLARIS /opt/ws/
demais UNIXs /usr/local/ws/

If WideStudio is extracted to the following directory, you will need to configre as below
Diretório de Instalação: /export/home/ws/
csh - variável de ambiente
 setenv WSDIR /export/home/ws
. setenv PATH xxxxxx:/export/home/ws/bin
. setenv LD_LIBRARY_PATH xxxxxx:/export/home/ws/lib
sh - variável de ambiente WSDIR="/export/home/ws";export WSDIR
. PAHT="xxxxxx:/export/home/ws/bin";export PATH
. LD_LIBRARY_PATH="xxxxxx:/export/home/ws/lib";export LD_LIBRARY_PATH

csh utiliza ".cshrc" e sh utiliza ".profile" para ajusta a variáve de ambiente. Mais detalhes sobre configuração das variáveis de ambientes podem ser obtidas nos respectivos manuais do SOs.
Uma vez editado ".cshrc", é necessário utilizar o comando "rehash" para proceder às alterações de modo que elas sejam efetivadas no ambiente. Fazer um "logooff" e um novo "login" também pode resolver.
Please feel free to contact us for any questions/bugs after checking the mailing list