Warning : moving library to mavenCentral required it to change groupId. now it will be renamed to io.github.raghavsatyadev.moreapps from previous id com.rocky.moreapps

MoreApps

Showcase your other apps in a beautiful way. This library also includes force updater.

Setup

To use this library your minSdkVersion must be >= 19.

Current version:

In the root build.gradle add

allprojects {
    repositories {
        mavenCentral()
    }
}

In the build.gradle of your app module add:

dependencies {
    implementation 'io.github.raghavsatyadev:moreapps:x.x.x'
}

Initial Setup

Manifest.xml

<application>
 <provider	
    android:name="androidx.work.impl.WorkManagerInitializer"	
    android:authorities="${applicationId}.workmanager-init"	
    android:exported="false"	
    tools:node="remove"	
    />	
</application>

Application Class

class CoreApp : Application(), Provider {
    override fun getWorkManagerConfiguration(): Configuration {
        return Builder()
            .setMinimumLoggingLevel(if (BuildConfig.DEBUG) Log.DEBUG else Log.ERROR)
            .build()
    }
}

Build.Gradle App Module

dependencies {
    implementation "androidx.work:work-runtime:2.8.0-beta01"
}

Example (More Apps Dialog)

Basic

MoreAppsBuilder(requireContext(), CoreApp.JSON_FILE_URL)
    .buildAndShow(object : MoreAppsDialogListener {
        override fun onClose() {
            // on dialog close
        }

        override fun onAppClicked(appsModel: MoreAppsDetails) {
            // on item click
        }
    })

Customization

MoreAppsBuilder(requireContext(), CoreApp.JSON_FILE_URL)
    .removeApplicationFromList("com.appdroidtechnologies.whatscut") // to remove an application from the list, give package name here
    .removeApplicationFromList(listOf("com.appdroidtechnologies.whatscut")) // to remove applications from the list, give package names here
    .dialogTitle(string.more_apps) // custom dialog title
    .dialogLayout(io.github.raghavsatyadev.moreapps.R.layout.more_apps_view) // custom dialog layout, read more instructions in it's javadoc
    .dialogRowLayout(io.github.raghavsatyadev.moreapps.R.layout.row_more_apps) // custom list item layout, read more instructions in it's javadoc
    .openAppsInPlayStore(true) // on clicking the item, should it open in the play store
    .font(font.sans_bold) // custom font
    .theme(
        Color.parseColor("#F44336"),
        Color.parseColor("#FFFFFF")
    ) // custom theme color, read more in javadoc,
    // default colorPrimary-colorOnPrimary of theme
    .rowTitleColor(Color.parseColor("#000000")) // custom list item title color
    .rowDescriptionColor(Color.parseColor("#888888")) // custom list item description color
    .setPeriodicSettings(
        15,
        TimeUnit.MINUTES,  // set interval of detail updating and showing notifications as required, default is 7 days
        mipmap.ic_launcher,
        drawable.ic_small_icon
    ) // launcher icon and small icon (small icon is optional, small icon should be of single color)
    .buildAndShow(object : MoreAppsDialogListener {
        override fun onClose() {
            // on dialog close
        }

        override fun onAppClicked(appsModel: MoreAppsDetails) {
            // on item click
        }
    })

Example (Force Updater)

Application Class

moreAppsDialog = MoreAppsBuilder(this, JSON_FILE_URL)
    .setPeriodicSettings(
        15,
        MINUTES, // set interval of detail updating and showing notifications as required, default is 7 days
        R.mipmap.ic_launcher,
        R.drawable.ic_small_icon // launcher icon and small icon (small icon is optional, small icon should be of single color)
    )
    .build() //calling this method in application class would be recommended

Calling Method (Writing in Launcher Activity's onCreate method is recommended)

ForceUpdater.showDialogLive(
        requireContext(), this, style.CustomDialog, object : MoreAppsLifecycleListener {
        override fun onStart() {
        // Activity or Fragment's onStart LifeCycle Method
        }

        override fun onStop() {
        // Activity or Fragment's onStop LifeCycle Method
        }

        override fun showingDialog() {
        // stop other work till this dialog is showing
        }

        override fun onComplete() {
        // do other work
        }
        })

Json File Format

NOTE : redirect_details, soft_update_details, hard_update_details are only required for Force Updater.

[
  {
    "image_link": "https://lh3.googleusercontent.com/DdGcPVh9kkUSdL2dKAUcGmejPXaNwnfbS5y5XtMFsXVST-GThQVzlwGgwwj7yOpII6-T=s180-rw",
    "name": "More Apps",
    "rating": 5,
    "app_link": "https://play.google.com/store/apps/details?id=com.rocky.moreapps.example",
    "package_name": "com.rocky.moreapps.example",
    "description": "Showcase your other apps in a beautiful way. This library also includes force updater.",
    "min_version": 6,
    "current_version": 7,
    "show_in_dialog": true,
    "redirect_details": {
      "enable": false,
      "hard_redirect": false,
      "dialog_title": "Redirect Notice",
      "dialog_message": "We have uploaded our app to new location",
      "positive_button": "Redirect",
      "negative_button": "Cancel",
      "app_link": "https://play.google.com/store/apps/details?id=com.rocky.moreapps.example"
    },
    "soft_update_details": {
      "enable": true,
      "dialog_show_count": 3,
      "notification_show_count": 3,
      "dialog_title": "Update Required!",
      "dialog_message": "Soft Update is required",
      "positive_button": "Update",
      "negative_button": "Cancel"
    },
    "hard_update_details": {
      "enable": true,
      "dialog_title": "Update Required!",
      "dialog_message": "Hard Update is required",
      "positive_button": "Update"
    }
  }
]

Understanding JSON fields

Field	Description
show_in_dialog	if false this app will not show up in more apps dialog
redirect_details	enable this to point users to download the app from new location (helpful when google removes the app from playstore)
redirect_details->hard_redirect	won't let the user go into the app
redirect_details->app_link	new location of APK
soft_update_details	to show that there is a new version available for downloading
soft_update_details->dialog_show_count	how many times the soft update dialog should show up for current update(updating current version in json will reset the counter)
soft_update_details->notification_show_count	how many times the soft update notification should show up for current update(updating current version in json will reset the counter)
hard_update_details	to show that this update of the app is no longer useful, user has to download new update

File is available at : https://github.com/raghavsatyadev/MoreApps/blob/master/Resources/more_apps.json

Example Application

Link : https://play.google.com/store/apps/details?id=com.rocky.moreapps.example

Preview

This library uses

• SimpleRatingBar : https://github.com/FlyingPumba/SimpleRatingBar
• Glide : https://github.com/bumptech/glide

Icons made by Smashicons from www.flaticon.com is licensed by CC 3.0 BY

Licence

Copyright 2022 Raghav Satyadev

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.