Construindo uma Aplicação Aimsun Next API com Xcode

Desenvolver uma Extensão Aimsun Next API em C++ (microscópica ou mesoscópica) no Mac OS X requer o uso do Xcode. Este guia cobrirá todos os passos para instalar o Xcode, criar um novo projeto, e em seguida, rodar e depurar a extensão.

Instalando o Xcode

O Xcode é uma instalação gratuita disponível na App Store do Mac OS X.

Criando um Projeto

Inicie o Xcode. No menu Arquivo, escolha: Novo, depois Projeto. Isso abrirá o seletor de templates. Selecione o template Biblioteca do OS X, Framework & Biblioteca.

Dê um nome ao produto, um identificador de organização (o domínio da sua organização em ordem reversa, por exemplo) e selecione as configurações STL (Biblioteca C++) e Dinâmica.

Selecione uma pasta para conter o projeto.

Adicionando arquivos de código-fonte

O Xcode adiciona três arquivos com as extensões hpp e cpp. Copie para o mesmo local os 6 arquivos incluídos na pasta cpp do arquivo DMG do Aimsun nomeados: - AAPI.cxx - AAPI.h - AAPI_Util.h - AKIProxie.h - ANGConProxie.h - CIProxie.h

Use a opção Mostrar no Finder para localizar a pasta.

Após copiar os arquivos, adicione-os ao projeto usando o comando Adicionar Arquivos a...

Finalmente, remova os três arquivos criados automaticamente pelo Xcode. Após isso, o novo projeto conterá 6 arquivos.

Adicionando a biblioteca Aimsun Next Kernel

Antes de compilar nosso código, informe ao Xcode onde as bibliotecas Aimsun estão localizadas. Selecione a entrada superior no navegador de Projetos. À direita, selecione "Configurações de Compilação" e pressione Todos.

Role para baixo até o grupo de Vinculação. Edite a configuração Outras Flags do Linker para conter o seguinte texto:

-L/"Applications/Aimsun Next.app/Contents/PlugIns" -la2kernel -lacontrol

Mudando a Localização de Compilação

É recomendado, mas não obrigatório, mudar a localização de compilação para estar ao lado do código-fonte da extensão. Para fazer isso, siga este guia.

A configuração da localização para Personalizada, e depois Relativa ao Espaço de Trabalho é recomendada.

Compilando e Executando

Pressione a seta de Play no canto superior esquerdo do Xcode para compilar a extensão. Use Mostrar no Finder sobre seu dylib para localizá-lo.

Abra o Aimsun Next, carregue o documento Aimsun, vá para a aba Editor de Cenários: Aimsun Next API. Na caixa da API, pressione Adicionar e localize a extensão (arquivo DYLIB).

Execute a simulação para usar a extensão.

Depurando

Para depurar a nova extensão, inicie o Aimsun Next e carregue o documento Aimsun. Antes de iniciar a simulação, vá para o Xcode e selecione a opção Anexar ao Processo no menu Depuração.

Defina pontos de interrupção conforme necessário e, quando estiver pronto, inicie a simulação.