Gira+

Gira+ é uma re-implementação da aplicação Gira da Câmara Municipal de Lisboa/EMEL. Com um olhar atento ao design, à experiência do utilizador (UX) e à estabilidade, este projeto visa proporcionar uma experiência de utilização mais agradável ao sistema de bicicletas partilhadas de Lisboa.

Funcionalidades extra

• Mapa com ciclovias
• Modo escuro
• Sistema de navegação
• Estimativa da condição das bicicletas em função das avaliações contribuídas pelos utilizadores
• Cálculo de métricas relevantes durante uma viagem
• Visualização das bicicletas que estão a caminho de uma estação

Não implementado

• Criação de contas
• Carregamento de saldo
• Compra de passes
• Histórico de passes e carregamentos

Desenvolvimento

A aplicação está a ser desenvolvida em SvelteKit, juntamente com a biblioteca Capacitor para compilar para Android.

Instalação e Compilação

Android

A aplicação está disponível no Google Play, e será também brevemente disponibilizada no F-Droid.

É possível também descarregar o APK da versão mais recente da aplicação aqui.

Alternativamente, a aplicação pode ser compilada através dos seguintes passos:

1. Preparação:

• Garantir que o Android SDK está instalado.

2. Configuração:

git clone [email protected]:rt-evil-inc/gira.git
cd gira

• Criar um ficheiro android/local.properties com o caminho para o Android SDK, como no exemplo:

sdk.dir=/opt/android-sdk/

3. Compilação:

npm install
npm run build-app

ou

bun install
bun run build-app

O ficheiro .apk será criado em android/app/build/outputs/apk/debug/app-debug.apk

iOS

A aplicação está disponível na App Store.

Alternativamente, a aplicação pode ser compilada através dos seguintes passos:

1. Preparação:

• Garantir que o Xcode está instalado.
• Instalar Cocoapods, caso necessário: brew install cocoapods

2. Configuração:

git clone [email protected]:rt-evil-inc/gira.git
cd gira

3. Compilação:

npm install
npm run build
npx cap run ios

ou

bun install
bun run build
bunx cap run ios

[!NOTE] Para instalar num iPhone físico (em vez do simulador) é necessária uma conta Apple Developer. No Xcode, em Signing & Capabilities do target GiraMais, escolha a sua equipa e altere o Bundle Identifier para um valor próprio (por exemplo com.exemplo.giraplus), já que dev.tteles.giraplus está registado à equipa do projeto. Não inclua essa alteração em pull requests.

Contribuição

Contribuições são bem-vindas! Consulte o ficheiro CONTRIBUTING.md para mais informações sobre como contribuir para o projeto.

Licença

Este projeto está licenciado sob a licença GNU General Public License v3.0, com uma permissão adicional que concede aos contribuidores originais do projeto, Rodrigo e Tiago, o direito de disponibilizar o projeto sob qualquer licença adicional no futuro, sem remover a licença GPL v3 da versão atual do projeto. O intuito desta permissão adicional é possibilitar a utilização do código para fins que não sejam compatíveis com código open-source, desde que com autorização explícita dos contribuidores originais.

Consulte o ficheiro LICENSE para os termos completos.

Misc

Cumprimentos ao @afonsosousah, que inspirou o projeto com a mGira.
Obrigado ao @joaodcp, que ajudou com esforços de reverse engineering do sistema original.
Agradecimentos à Inês Freitas pelo design do logotipo da aplicação.