Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aitorastorga/randomnumbergenerator

Ionic app that generates configurable random numbers. Release in the Play Store coming soon :)
https://github.com/aitorastorga/randomnumbergenerator

android capacitor-android ionic-framework ionic7

Last synced: 28 days ago
JSON representation

Ionic app that generates configurable random numbers. Release in the Play Store coming soon :)

Host: GitHub
URL: https://github.com/aitorastorga/randomnumbergenerator
Owner: AitorAstorga
License: gpl-3.0
Created: 2023-12-13T20:45:13.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-01-18T22:36:25.000Z (almost 1 year ago)
Last Synced: 2024-12-20T19:29:54.381Z (29 days ago)
Topics: android, capacitor-android, ionic-framework, ionic7
Language: TypeScript
Homepage:
Size: 9.88 MB
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        [![Contributors][contributors-shield]][contributors-url]

[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![MIT License][license-shield]][license-url]

[![LinkedIn][linkedin-shield]][linkedin-url]






  

    

  

  
Random Number Generator


  


    Ionic app that generates configurable random numbers

    


    Explore the docs »

    


    


    View Demo

    ·

    Report Bug or 

    ·

    Request Feature

  



  Table of Contents

  


    

      About The Project

      

        Built With

      

    

    

      Getting Started

      

        Prerequisites

        Installation

      

    

    

      Serve

    

    

      Build

      

        Generating a release build

        Running with Android Studio

      

    

    Contributing

    License

    Contact

    Acknowledgments

  


## About The Project

This project is about creating a simple yet powerful random number generator using the Ionic framework. It's designed to be user-friendly and highly customizable, allowing users to specify the range and criteria for number generation.

  Screenshot

  

(back to top)


### Built With

This project is built with the following technologies:

* ![Ionic](https://img.shields.io/badge/Ionic-%233880FF.svg?style=for-the-badge&logo=Ionic&logoColor=white)

* ![Angular](https://img.shields.io/badge/angular-%23DD0031.svg?style=for-the-badge&logo=angular&logoColor=white)

* ![Capacitor](https://img.shields.io/badge/Capacitor-119EFF?style=for-the-badge&logo=Capacitor&logoColor=white)

* ![Android Studio](https://img.shields.io/badge/Android_Studio-3DDC84?style=for-the-badge&logo=android-studio&logoColor=white)

* ![Visual Studio Code](https://img.shields.io/badge/Visual_Studio_Code-0078D4?style=for-the-badge&logo=visual%20studio%20code&logoColor=white)

(back to top)


## Getting Started

To get a local copy up and running follow these simple example steps.

### Prerequisites

Update npm (or install it otherwise)

```sh

sudo npm install npm@latest -g

```

Install the Ionic Framework

```sh

sudo npm i -g @ionic/cli

```

You will need Android Studio if you want to build the apk.

### Installation

1. Clone the repo

   ```sh

   git clone https://github.com/AitorAstorga/RandomNumberGenerator.git

   ```

2. Install NPM packages

   ```sh

   npm install

   ```

(back to top)


## Serve

You can create a live server in a web browser with Ionic. Use the command:

```sh

ionic serve

```

You will be prompted to install `@angular/cli`. Install it.

```sh

> ng run app:serve --host=localhost --port=8100

[INFO] Looks like @angular/cli isn't installed in this project.

       

       This package is required for this command to work properly. The package provides a CLI utility, but the ng binary

       was not found in your PATH.

? Install @angular/cli? Yes

```

(back to top)


## Build

This project is built using Ionic 7.1.5 and Capacitor.

Follow the official Ionic documentation:

- https://ionicframework.com/docs/deployment/play-store

- https://capacitorjs.com/docs/next/android

### Generating a release build

Build the web app:

```

ionic build

```

To generate a release build for Android run the following cli command:

```

npx cap copy && npx cap sync

```

This will copy all web assets and sync any plugin changes.

Next, open Android studio:

```

npx cap open android

```

Then, generate an APK in Android Studio:

- https://developer.android.com/build/build-for-release

#### Error Unable to launch Android Studio

This error looks like this:

```sh

npx cap open android

[error] Unable to launch Android Studio. Is it installed?

        Attempted to open Android Studio at: /usr/local/android-studio/bin/studio.sh

        You can configure this with the CAPACITOR_ANDROID_STUDIO_PATH environment variable.

```

If you get it in Linux and you installed Android Studio previously you can fix it by doing:

```sh

export CAPACITOR_ANDROID_STUDIO_PATH="/opt/android-studio/bin/studio.sh"

```

### Running with Android Studio

In Android Studio, first select the device or emulator and then click the run or debug button to run your app. Unless you're debugging Java or Kotlin code, the run button is preferred.

![Run in Android Studio](https://capacitorjs.com/docs/assets/images/running-a42ce0daf3b9d2dd5ee6b94d1c378220.png)

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

1. Fork the Project

2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)

3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)

4. Push to the Branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request

(back to top)


## License

Distributed under the GNU General Public License v3.0. See `LICENSE` for more information.

(back to top)


## Contact

Aitor Astorga Saez de Vicuña - [email protected]

Project Link: [https://github.com/AitorAstorga/RandomNumberGenerator](https://github.com/AitorAstorga/RandomNumberGenerator)

(back to top)


## Acknowledgments

Thanks to these nice projects!

* [Ionic Framework](https://ionicframework.com/)

* [Angular](https://angular.io/)

* [Capacitor](https://capacitorjs.com)

* [Img Shields](https://shields.io)

* [markdown-badges](https://github.com/Ileriayo/markdown-badges#table-of-contents)

(back to top)


[contributors-shield]: https://img.shields.io/github/contributors/AitorAstorga/RandomNumberGenerator.svg?style=for-the-badge

[contributors-url]: https://github.com/AitorAstorga/RandomNumberGenerator/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/AitorAstorga/RandomNumberGenerator.svg?style=for-the-badge

[forks-url]: https://github.com/AitorAstorga/RandomNumberGenerator/network/members

[stars-shield]: https://img.shields.io/github/stars/AitorAstorga/RandomNumberGenerator.svg?style=for-the-badge

[stars-url]: https://github.com/AitorAstorga/RandomNumberGenerator/stargazers

[issues-shield]: https://img.shields.io/github/issues/AitorAstorga/RandomNumberGenerator.svg?style=for-the-badge

[issues-url]: https://github.com/AitorAstorga/RandomNumberGenerator/issues

[license-shield]: https://img.shields.io/github/license/AitorAstorga/RandomNumberGenerator.svg?style=for-the-badge

[license-url]: https://github.com/AitorAstorga/RandomNumberGenerator/blob/master/LICENSE

[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[linkedin-url]: https://linkedin.com/in/aitor-astorga-saez-de-vicuña

[product-screenshot]: images/screenshot.png