Description
What is Roguin
Social Network integrations can be a pain to write and maintain. This goes double if you want to add more than one Network into a single project. With Roguin, the whole process is simplified and Google, Facebook and Twitter are unified and handled with the same code.
Roguin alternatives and similar packages
Based on the "Kotlin" category.
Alternatively, view Roguin alternatives based on common mentions on social networks and blogs.
-
android-youtube-player
YouTube Player library for Android and Chromecast, stable and customizable. -
CalendarView
A highly customizable calendar view and compose library for Android. -
Balloon
:balloon: Modernized and sophisticated tooltips, fully customizable with an arrow and animations for Android. -
Kotterknife
Android view injection writen in Kotlin based on ButterKnife -
kotlin-android-template
Android + Kotlin + Github Actions + ktlint + Detekt + Gradle Kotlin DSL + buildSrc = โค๏ธ -
NotyKT ๐๏ธ
๐ NotyKT is a complete ๐Kotlin-stack (Backend + Android) ๐ฑ application built to demonstrate the use of Modern development tools with best practices implementation๐ฆธ. -
Material Chip View
Material Chip view. Can be used as tags for categories, contacts or creating text clouds -
DrawableToolbox
๐ ๏ธ The missing drawable toolbox for Android. Create drawables programmatically and get rid of the boring and always repeated drawable.xml files. -
Navigation Toolbar for Android
:octocat: Navigation toolbar is a slide-modeled UI navigation controller made by @Ramotion -
Carousel Recyclerview
Carousel Recyclerview let's you create carousel layout with the power of recyclerview by creating custom layout manager. -
Pluto Debug Framework
Android Pluto is a on-device debugging framework for Android applications, which helps intercept Network calls, capture Crashes & ANRs, manipulate application data on-the-go, and much more. -
Android Kotlin Samples
Some basic samples of Kotlin for Android -
Pdf Viewer For Android
A Lightweight PDF Viewer Android library which only occupies around 125kb while most of the Pdf viewer occupies up to 16MB space. -
CrunchyCalendar โ awesome calendar widget for android apps
A beautiful material calendar with endless scroll, range selection and a lot more! -
MaterialTimelineView
With MaterialTimelineView you can easily create a material looking timeline. -
sliding-panel
Android sliding panel that is part of the view hierarchy, not above it. -
Capturable
๐Jetpack Compose utility library for capturing Composable content and transforming it into Bitmap Image๐ผ๏ธ -
MaterialDrawerKt
A Kotlin DSL wrapper around the mikepenz/MaterialDrawer library. -
Transition X
{ } Declarative Kotlin DSL for choreographing Android transitions -
SSComposeCookBook
A Collection of major Jetpack compose UI components which are commonly used.๐๐๐ -
Only
:bouquet: An easy way to persist and run code block only as many times as necessary on Android. -
SSCustomBottomNavigation
Animated TabBar with native control and Jetpack Navigation support..โจ๐๐ -
Swagger Gradle Codegen
๐ซ A Gradle Plugin to generate your networking code from Swagger -
Permission Flow for Android
Know about real-time state of a Android app Permissions with Kotlin Flow APIs. -
EasyPermissions-ktx
๐ Kotlin version of the popular google/easypermissions wrapper library to simplify basic system permissions logic on Android M or higher. -
Awesome Jetpack compose
A collaborative list of awesome jetpack compose resources. -
Nextflix-Composable
Includes jetpack compose, navigation, paging, hilt, retrofit, coil, coroutines, flow.. -
DeviceInfo-Sample
[Android Library] Get easy access to device information super fast, real quick -
Intro Showcase View
Highlight different features of the app using Jetpack Compose -
Aimybox voice assistant
Embeddable custom voice assistant for Android applications -
Events Calendar
Events Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. It can be done easily, you are just a few steps away from implementing your own badass looking Calendar for your very own project! -
ZoomHelper
ZoomHelper will make any view to be zoomable just like Instagram pinch-to-zoom -
Mutekt
Simplify mutating "immutable" state models (a Kotlin multiplatform library) -
SSCustomEditTextOutLineBorder
Same as the Outlined text fields presented on the Material Design page but with some dynamic changes. ๐ ๐ -
Maildroid
Maildroid is a small robust android library for sending emails using SMTP server -
Turtle ๐ข
Run shell commands from Kotlin scripts, apps or Gradle tasks with ease. -
TimelineView
A customizable and easy-to-use Timeline View library for Android. Works as a RecyclerView decorator (ItemDecoration) -
Compose Compiler Reports to HTML Generator
A utility (Gradle Plugin + CLI) to convert Jetpack Compose compiler metrics and reports to beautified HTML page. -
Crowdin Android SDK
Crowdin Android SDK delivers all new translations from Crowdin project to the application immediately -
Vanilla Place Picker
Simple(vanilla) yet 'Do it all' place picker for your place picking needs in Android
Appwrite - The Open Source Firebase alternative introduces iOS support
Do you think we are missing an alternative of Roguin or a related project?
README
Roguin
One stop shop for Social Network integrations
Use the same code for Google, Facebook and Twitter
What is Roguin
Social Network integrations can be a pain to write and maintain. This goes double if you want to add more than one Network into a single project. With Roguin, the whole process is simplified and Google, Facebook and Twitter are unified and handled with the same code.
You can add a 'Sing In With' feature for all three networks with the same exact code!
Preparation
Roguin helps with code but you still need valid Applications as per Social Network regulations and guidelines. So, you would still need to:
- Configure a Project for Google through https://developers.google.com/identity/sign-in/android/start-integrating#configure_a_console_name_project
- Create A New App for Facebook through https://developers.facebook.com/docs/facebook-login/android
- Create a New Twitter App from https://apps.twitter.com
Installation
1. Dependency
implementation 'com.izikode.izilib:roguin:0.3'
2. Social Network Application keys
You must add your valid App key and secrets in Manifest placeholders, for both Facebook and Twitter. Google does not require this. So in your app's build.gradle file, add the following:
android {
defaultConfig {
manifestPlaceholders = [
facebook_api_key : 'my valid facebook app key',
twitter_api_key : 'my valid twitter app key',
twitter_api_secret : 'my valid twitter app secret'
]
}
}
3. Extend RoguinActivity
Every social network SDK uses the startActivityForResult
in one way or another. In the spirit of making stuff as easy as possible, Roguin provides a Base Activity class, RoguinActivity
which handles registering, unregistering, request codes and the lot. Just extend in your Activities and you are done.
4. Endpoint initialization
Prior to using, the Endpoints you need must be initialized. A good place to do this is in the onCreate
of your app's Application class. And you can do so like this:
class MyApplication : Application() {
override fun onCreate() {
super.onCreate()
GoogleEndpoint.initialize(this)
FacebookEndpoint.initialize(this)
TwitterEndpoint.initialize(this)
}
}
Usage
All three wrappers, GoogleEndpoint, FacebookEndpoint and TwitterEndpoint, implement the RoguinEndpoint
interface. So they all expose the following:
val isSignedIn
for checking the Sign In status for your app.fun requestSignIn
for starting a new Sing In flow in your app.fun requestSignOut
for starting a new Sign Out flow in your app.fun requestProfile
for getting Basic Profile information of the logged in user.
The following code is an outtake from the demo project in this repository and shows how simple signing in and out of all three networks is with Roguin.
googleButton.setOnClickListener {
if (googleEndpoint.isSignedIn) {
googleEndpoint.requestSignOut { success ->
if (success) {
googleStatus.text = "Google is DISCONNECTED"
}
}
} else {
googleEndpoint.requestSignIn { success, token, error ->
if (success) {
googleStatus.text = "Google is CONNECTED"
}
}
}
}
facebookButton.setOnClickListener {
if (facebookEndpoint.isSignedIn) {
facebookEndpoint.requestSignOut { success ->
if (success) {
facebookStatus.text = "Facebook is DISCONNECTED"
}
}
} else {
facebookEndpoint.requestSignIn { success, token, error ->
if (success) {
facebookStatus.text = "Facebook is CONNECTED"
}
}
}
}
twitterButton.setOnClickListener {
if (twitterEndpoint.isSignedIn) {
twitterEndpoint.requestSignOut { success ->
if (success) {
twitterStatus.text = "Twitter is DISCONNECTED"
}
}
} else {
twitterEndpoint.requestSignIn { success, token, error ->
if (success) {
twitterStatus.text = "Twitter is CONNECTED"
}
}
}
}
For a full example, see the sample app.
Licence
Copyright 2018 Fanis Veizis
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.
*Note that all licence references and agreements mentioned in the Roguin README section above
are relevant to that project's source code only.