/Odevio-CLI

Odevio, the easy way to setup, build & release flutter apps for iOS on Linux, Windows and MacOS

Primary LanguagePythonMIT LicenseMIT


https://img.shields.io/badge/version-1.2.1-blue https://img.shields.io/github/license/odevio/odevio-cli https://img.shields.io/librariesio/release/pypi/odevio https://img.shields.io/pypi/dm/odevio UptimeRobot CodeFactor Discord

The easy way to setup, build & release flutter apps for iOS on Linux, Windows and MacOS

Odevio is a tool to help developers setup and release their Flutter apps on iOS. Thanks for checking it out.

https://raw.githubusercontent.com/Odevio/Odevio-CLI/master/docs/img/odevio--demo.gif

A tool for developers by developers

Installation

Odevio is a CLI utility developed in Python. It is easily installed with pip.

pip install odevio

Usage

To start using Odevio simply run odevio in your console.

Start by creating an account

odevio signup

Your Odevio account is now created and you can either start a build machine in configuration mode : to configure XCode or test your app in the iOS simulator.

odevio build start --build-type configuration

Or you can build an IPA or release your app by linking your Apple Developer Account to Odevio and creating an app identifier

odevio apple add --apple-id APPLE_TEAM_ID --name TEXT --key-id APPLE_KEY_ID --issuer-id APPLE_ISSUER_ID --private-key LOCATION_APPLE_PRIVATE_KEY
odevio app mk --name MY_APP_NAME --bundle-id COM.COMPANY.APP_NAME

To create the IPA to install on a physical device for testing purposes

odevio build start --build-type ad-hoc
odevio build ipa

To publish directly to the App Store

odevio build start --build-type publication

Your build failed ? No worries, you can check the logs with

odevio build logs

Documentation

All documentation is in the docs directory and online at https://odevio.readthedocs.io/. If you are getting started this is how we recommend you use the docs :

About

Our mission is to reduce the time it takes to setup, build and release Flutter apps on iOS to the bare minimum.

The tool allows developers working alone or in teams and on multiple OS (Linux, Windows, MacOS) to build and publish their apps easily to the app store.

What can Odevio be used for ?

  1. It allows you to setup the XCode project on a remote MacOS machine if you do not own one.
  2. It manages common iOS specific settings for your team : certificates, devices, provisioning profiles, bundle IDs, Xcode configuration files, ...
  3. It builds your Flutter app on remote iOS machines.
  4. It hosts the iOS app artifacts or publish them to the App Store.

Contributing

Thank you for considering contributing to Odevio. The main purpose of this repository is to continue evolving Odevio to make Flutter developer's lives easier.

Please report improvements, bugs and issues to Github's issue tracker. Pull requests linked to open issues are even more appreciated.

Odevio's GitHub issue tracker is not intended to provide help or support. For that check out our discord.

We are also thrilled to receive a variety of other contributions including:

  • Documentation updates, enhancements, designs, or bugfixes.
  • Spelling or grammar fixes.
  • Blogging, speaking about, or creating tutorials about Odevio.

Giving Odevio a Github star is much appreciated by our team ! Sharing our project with other Flutter developers is too :)