search

rubygarage / shopapp-android

ShopApp is an application that transfers an online store into a mobile app
Apache License 2.0
169 stars 107 forks source link
android android-application android-development android-library ecommerce ecommerce-shopping-solution ecommerce-store ecommerce-storefront kotlin kotlin-android kotlin-library shopify-client shopping-android-app

readme

Build Status codecov

ShopApp for Android

ShopApp connects with popular ecommerce platforms like Shopify, Magento, BigCommerce, and WooCommerce to transfer them into a mobile app for iOS and Android. So far, we’ve developed a Shopify provider for Android and Shopify provider for iOS. Currently we’re working on adding more providers and extending the features list, so stay in touch with our updates.

Installation

To install the dependencies required for an application build, ShopApp uses Gradle. Connect one of the providers for an online store and install all the dependencies. As an example, let's use Shopify.

  1. Add the following line to app/build.gradle: 
    implementation "com.github.rubygarage:shopapp-shopify-android:1.0.4"

Also, you'll have to configure the provider to get an access to your online store. To configure the provider, follow the instructions on a provider's page . For a Shopify provider, the flow is following:

  1. Add the following code: 

    val api = ShopifyApi(this, "BASE DOMAIN", "STOREFRONT ACCESS TOKEN", "API KEY", "API PASSWORD") //Initialize your api here. 
appComponent = buildAppComponent(api, dao)

    to the file app/src/main/java/com/shopapp/ShopApplication.kt.

  2. You'll also have to configure the provider to receive an access to your store. To get an access, follow the instructions on a provider's page.

Check out how to configure the Shopify provider.

  1. After that, you'll be able to open the project file and launch an app.

To create a client for another SaaS provider, you have to add the following dependency to the dependencies:

implementation 'com.github.rubygarage:shopapp-android:1.0.5'

  1. Next, create a class that'll interact with the main application and implement the API interface.

  2. After that you'll be able to add a new client to the main application:

Requirements

License

The ShopApp for Android is licensed under the Apache 2.0 license

RubyGarage Logo

RubyGarage is a leading software development and consulting company in Eastern Europe. Our main expertise includes Ruby and Ruby on Rails, but we successfully employ other technologies to deliver the best results to our clients. Check out our portfolio for even more exciting works!