OpenBrews：采用Ionic框架构建的一个brewing app支持iOS和Android

OpenBrews：采用Ionic框架构建的一个brewing app支持iOS和Android

A brewing app for iOS and Android, built with Ionic Framework.

Alpha Release

Go to our Releases page to download our Alpha release. This supports Android 4.1 and up.

Setup/Usage

Prereqs

Ionic installed globally npm install -g cordova ionic Gulp installed globally npm install -g gulp

Testing Prereqs

Karma installed globally npm install -g karma-cli

Steps to run locally

Clone this repository git clone git@github.com:OpenBrews/OpenBrews.git cd into the repository folder.Clone the repo's submodules git submodule update --init --recursive Install the remaining dependencies with npm install.Finally, you can run the app via gulp && ionic serve [--lab].

Steps to run on your phone (with Ionic view)

First, follow the steps above to run the app locally.Download the Ionic View App on your mobile device.Create an Ionic View account.cd into the repository folderRun ionic upload. You will be prompted for your ionic view credentials. If you receive an error such as zip cannot be found, press Ctrl+c to stop the process. Run mv openbrews.zip zip, and run ionic upload again.

Steps to run unit tests

First, follow the steps to run the app locally, making sure your modules are up-to-date.Install the Testing prereqs above.cd into the openbrews/ directory.Run karma start

Deploying the App

Android

Follow the steps to run locally above.Download the Android SDKcd into the OpenBrews/ folder.Run ionic build android

This will build an APK for debugging. To release an official version you need to use the --release flag, and I (Mike) need to sign it with my private key.

iOS

TODO

Optional Configuration

If you would like to use features which utilize the brewerydb API, please create an account and get your own API key here. This should be added to your openbrews/config.json file. If you do not have a config.json file, copy and rename openbrews/example.config.json.

Note: To make requests to the BreweryDB API in the browser you will need to allow CORS in the browser you are using.

Developers

Ask for a Slack Invite

Please, don't be afraid to ask for an invite to our slack chat. We can discuss problems and work through issues together. Email Mike for an invite.

Tech Stack

This app is built using Ionic Framework, which is built on AngularJS. If you have no idea what Ionic is, and only know AngularJS, you'll probably be fine. We are also leveraging Ionic CSS (rather than Bootstrap). Other than that, the project uses GULP, Bower, and SCSS.

Contributing

Monitor the Issues board for tasks that need to be completed. Check the comments on an issue to get all the background info and see if anyone else has started work on it. When you're ready to develop, fork the repository, do your work, and submit a PR. Please note that changes may be requested. If you become a regular contributor, I may add you as a collaborator to this repository.

Goals

Beta Pre-Release

We now have an Alpha release out, and we're working hard to deliver updates as fast as we can. Once the app is more stable and polished, we will release a Beta version on Android.

Release 1

Release 1 will focus on delivering a core Recipe Builder app. It will be a standalone application, except for some data-gathering API calls to BreweryDB.

Future

Down the line, I would like to have an Web App and an API that allows persistance of recipes across devices, public sharing of recipes, and more!

Contact

Email Mike with any questions or concerns you may have regarding this project.

Don't Forget to Star!

Remember, if you like what we're doing here, please star this repository :)

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。