Forem: EGEMEN

How to Share a Library on JitPack (Android)

EGEMEN — Sun, 28 May 2023 22:13:10 +0000

This comprehensive guide walks you through the process of sharing your Android library through JitPack. JitPack is a package repository for GitHub, simplifying the distribution and integration of libraries into other projects. Follow the step-by-step instructions below to get started and make your library accessible to developers worldwide.

Step 1: Create an Android Module

In your Android project, right-click and select "New Module."
Choose "Android Library" and create the module.
Within the module, write the functions you want to share. This module will serve as your library.

Additional Information: Creating a dedicated module for your library offers several benefits. It allows for better code organization, encapsulation, and reusability. Moreover, it enables you to focus on developing and maintaining a specific set of functionalities that can be easily integrated into other projects.

Step 2: Share the Project on GitHub

Host your project on GitHub and ensure its visibility is set to public. By making your project publicly accessible, you create opportunities for collaboration, feedback, and contributions from the developer community.

Additional Information: Sharing your project on GitHub opens doors for engaging with other developers, obtaining valuable feedback, and fostering collaboration. It provides a platform to showcase your work and make it accessible to a broader audience.

Step 3: Create a Library Version on GitHub

Go to your GitHub project page and navigate to the "Release" tab.
Create a new release to define a version for your library. Specify the version number, provide a detailed description of the release, and include any relevant version-specific information or updates.
Click on "Release" to publish the library version.

Additional Information: Creating distinct versions for your library allows users to choose a specific release based on their requirements and compatibility needs. By documenting the changes and improvements in each version, you provide developers with a clear understanding of the library's evolution.

Step 4: Share Your Library on JitPack

Once you have released a version on GitHub, your library is automatically prepared for sharing through JitPack.
Go to jitpack.io and log in using your GitHub account.
Paste the repository URL into the provided field.
Click on "Get it" to initiate the process of making your library available on JitPack.
JitPack will generate the necessary build artifacts and provide instructions on how to import and use your library in other projects.

Additional Information: JitPack seamlessly integrates with your GitHub repository, automating the build process and simplifying library distribution. It supports various build systems, including Gradle and Maven, making it easier for developers to incorporate your library into their projects.

Personal Growth and Contribution in Open-Source Projects

Publishing libraries and contributing to open-source projects offer several benefits to developers:

Personal Growth: By sharing your libraries, you gain exposure to a wider developer community. Collaborating with others, receiving feedback, and engaging in discussions can enhance your skills and broaden your perspectives.
Knowledge Sharing: Contributing to open-source projects allows you to share your expertise and insights with others. It fosters a culture of knowledge exchange, benefiting the entire software development community.
Portfolio Enhancement: Publishing libraries and actively participating in open-source projects serve as valuable additions to your professional portfolio. They demonstrate your technical capabilities, problem-solving skills, and commitment to the software development community.
Collaboration Opportunities: Open-source projects provide opportunities to collaborate with developers from diverse backgrounds. Working together on a shared codebase exposes you to different coding styles, development methodologies, and best practices.
Recognition and Networking: Contributing to open-source projects can lead to recognition within the developer community. It provides opportunities to network with like-minded individuals, potential employers, and industry experts.

Additional Information: When contributing to open-source projects, it is important to follow the project's guidelines, contribute meaningfully, and be respectful of the existing community. Engaging in discussions, submitting bug reports, providing documentation updates, and proposing new features are all valuable ways to contribute.

By sharing your libraries and actively participating in open-source projects, you contribute to the growth and advancement of the software development community as a whole. The knowledge and experience gained from these endeavors can have a significant impact on your personal growth as a developer.

TinderLike Cards - Android

EGEMEN — Sat, 26 Dec 2020 23:45:29 +0000

TinderLike Cards ♀️♂️

Stylish animations and designs like Tinder

Why this project exists

This project arose from the idea of turning a small part of freelance project I did a long time ago into a library. With TinderLike Cards library, you can easily have a tinder-style design. Since the project was written in the past, it may have problems. I will continue to improve the library with your help. Please be sure to report any issues you find. I took the structure of listview as an example for myself. You can easily include it in your project with the use of a simple adapter.

Features

[x] Kotlin
[x] Stylish Animations
[x] Customization
[x] CrashSafe
[x] Easy Implementation
[x] Application Variants

Let's Start 🚀

Define CardContainer in you main.xml

Make sure that container's layout_width and layout_height both are match_parent. I will explain it below. 🍭

<com.asynctaskcoffee.cardstack.CardContainer
     android:id="@+id/cardContainer"
     android:layout_width="match_parent"
     android:layout_height="match_parent" />

Setting CardContainerAdapter with your custom model

class MainAdapter(private val list: ArrayList<MainTestModel>, context: Context) :
    CardContainerAdapter() {

    var layoutInflater: LayoutInflater = LayoutInflater.from(context)

    override fun getItem(position: Int) = list[position]

    @SuppressLint("InflateParams")
    override fun getView(position: Int): View {
        val v = layoutInflater.inflate(R.layout.card_view, null)
        val userImageView = v.findViewById<ImageView>(R.id.userImage)
        val genderImageView = v.findViewById<ImageView>(R.id.genderImage)
        val userName = v.findViewById<TextView>(R.id.userName)
        val ageAndLastSeen = v.findViewById<TextView>(R.id.ageAndLastSeen)

        val user = getItem(position)

        Picasso.get().load(user.userImage).into(userImageView)
        genderImageView.setImageResource(user.userGender)

        userName.text = user.userName
        ageAndLastSeen.text = user.userAgeLastSeen

        return v
    }

    override fun getCount(): Int = list.size
}

Setting Adapter

lateinit var cardContainer: CardContainer
lateinit var adapter: MainAdapter
private var modelList = arrayListOf<MainTestModel>()

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    cardContainer = findViewById(R.id.cardContainer)

    /*Setting Adapter*/
    modelList.clear()
    modelList.addAll(MainHelper.getFemaleModels())
    adapter = MainAdapter(modelList, this)
    cardContainer.setAdapter(adapter)
}

Almost the same as listview, right? Let's continue with customization.

Before setting the adapter, you can set margin values and the number of visible stacks. The number of cards on the screen will be renewed according to the maxStackSize.

/*Customization*/
cardContainer.maxStackSize = 3
cardContainer.marginTop = 13.px
cardContainer.margin = 20.px

So why should I define these layouts as extra ❓😿 Because in card dragging operations, parent view cordinates are taken as basis. It is necessary to do this so that the dragged card does not conflict with the parent view.

/*Adding Extra Layouts*/
cardContainer.setEmptyView(generateEmptyView())
cardContainer.addFooterView(generateFooterView())
cardContainer.addHeaderView(generateHeaderView())

How to listen cardEvents? Here is CardListener and it's usage 🎉

fun onLeftSwipe(position: Int, model: Any)
fun onRightSwipe(position: Int, model: Any)
fun onItemShow(position: Int, model: Any)
fun onSwipeCancel(position: Int, model: Any)
fun onSwipeCompleted()

You can cast and use models according to the type you define. Ex (model as MainTestModel)

class MainActivity : AppCompatActivity(), CardListener {

   override fun onCreate(savedInstanceState: Bundle?) {
        /*Set Card Listeners*/
        cardContainer.setOnCardActionListener(this)
   }

    override fun onLeftSwipe(position: Int, model: Any) {/*card model shifted left*/}

    override fun onRightSwipe(position: Int, model: Any) {/*Card model shifted right*/}

    override fun onItemShow(position: Int, model: Any) {/*Current card model on screen*/}

    override fun onSwipeCancel(position: Int, model: Any) {/*If user canceled dragging*/}

    override fun onSwipeCompleted() {/*No more cards left*/}

}

What if I have pagination system for models or need to add more cards later ❓😿 Here is the solution 🎉

modelList.addAll(MainHelper.getFemaleModels())
adapter.notifyAppendData()

⚠️ This function just for appending new datas. Do not use it for change orders or data values. ⚠️

Can I throw cards left or right programmatically ❓🤔 Hmmm, YES YOU CAN ❗

You can call swipeLeft() or swipeRight() methods for it.

private fun setListeners(){
  cancelView.setOnClickListener {
      it.pulse() // for sweet animation
      adapter.swipeLeft()
  }
  likeView.setOnClickListener {
      it.pulse() // for sweet animation
      adapter.swipeRight()
  }
}

Implementation Gradle

Add it in your root build.gradle at the end of repositories

    repositories {
        maven { url 'https://jitpack.io' }
    }

Add the dependency

    dependencies {
         implementation 'com.github.AsynctaskCoffee:tinderlikecardstack:1.0'
    }

Implementation Maven

Add the JitPack repository to your build file

    <repositories>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
    </repositories>

Add the dependency

    <dependency>
        <groupId>com.github.AsynctaskCoffee</groupId>
        <artifactId>tinderlikecardstack</artifactId>
        <version>1.0</version>
    </dependency>

And please dont forget to star :)

https://github.com/AsynctaskCoffee/TinderLikeCardStack

Blurr - Easy Blur and Tools Library

EGEMEN — Wed, 26 Aug 2020 14:51:38 +0000

Blurr 🌁 Easy Blur and Tools Library

Simple and quick solution for blurred bitmaps.

Async or Sync, you can quickly blur your images. The library supports Bitmap, Drawable and CustomViews. You have the opportunity to use the necessary libraries separately. If you encounter an error or problem, please open a issue. It will be fixed as soon as possible. ⚡

Features

[x] Kotlin
[x] Rx3
[x] CustomView to Bitmap (usefull for markers - osm and gmap)
[x] Blurred Bitmaps
[x] Drawable to Bitmap
[x] Application Variants

General Usage

/**
* @param bitmapScale should be 0-1f -> small values for more blur
* @param blurRadius should be 0-25f -> bigger values for more blur
*
* @exception RSIllegalArgumentException Radius out of range (0 < r <= 25)
* @exception NullPointerException void android.graphics.Bitmap.setHasAlpha(boolean)
**/   

 fun applyRules(bitmapScale: Float, blurRadius: Float): Blurr {
   bS = bitmapScale
   bR = blurRadius
   return this
}

Convert Drawable to Blurred Bitmap (async)

Blurr.get(this)
     .applyRules(bS, bR)
     .into(resources.getDrawable(R.drawable.test_image), imageViewTrial) //async

Convert Drawable to Blurred Bitmap (sync)

val bitmap2 = Blurr
        .get(this)
        .applyRules(bS, bR)
        .solution(resources.getDrawable(R.drawable.test_image))

Convert View Blurred Bitmap (async)

Blurr.get(this)
     .applyRules(bS, bR)
     .into(view, imageViewTrial) //async

Convert View Blurred Bitmap (sync)

val bitmap1 = Blurr
        .get(this)
        .applyRules(bS, bR)
        .solution(view)

Convert Bitmap to Blurred Bitmap (async)

Blurr.get(this)
     .applyRules(bS, bR)
     .into(bitmap!!, imageViewTrial) //async

Convert Bitmap to Blurred Bitmap (sync)

val bitmap3 = Blurr
       .get(this)
       .applyRules(bS, bR)
       .solution(bitmap!!)

Tools: Bitmap From Custom Views

 val bitmap4 = Blurr
        .getTools()
        .bitmapFromCustomView(view)

Tools: Bitmap From Drawable

val bitmap5 = Blurr
        .getTools()
        .bitmapFromDrawable(resources.getDrawable(R.drawable.test_image))

Implementation Gradle

Add it in your root build.gradle at the end of repositories

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

Add the dependency

dependencies {
    implementation 'com.github.AsynctaskCoffee:BlurryAndroid:beta-0.1'
}

Implementation Maven

Add the JitPack repository to your build file

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Add the dependency

<dependency>
    <groupId>com.github.AsynctaskCoffee</groupId>
    <artifactId>BlurryAndroid</artifactId>
    <version>beta-0.1</version>
</dependency>

Android VideoLayout Library

EGEMEN — Fri, 07 Aug 2020 20:30:35 +0000

More stylish background designs
Performance friendly and scalable

Why this project exists

The normal videoview on Android is very costly in terms of performance. Also, due to the video resolution ratio and apk size, most developers don't want to include videos in the project. With this library, developers will have a performance-friendly video background with a few lines of code.

Features and Usage

Easy implementation

        frameLayout = findViewById(R.id.frameLayout)
        videoLayout = VideoLayout(this)
        videoLayout.setGravity(VideoLayout.VGravity.centerCrop)
        videoLayout.setIsLoop(true)
        videoLayout.setPathOrUrl("loginvideotype3.mp4") // could be any video url
        frameLayout.addView(videoLayout)

    <egolabsapps.basicodemine.videolayout.VideoLayout
            android:id="@+id/videoLayout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_gravity="center"
            app:video_gravity="centerCrop"
            app:path_or_url="loginvideotype3.mp4"
            app:loop="true"/>

You should put your mp4 files into assets folder, If you use URL you should declare

   <uses-permission android:name="android.permission.INTERNET"/>

Implementation

Add it in your root build.gradle at the end of repositories

    repositories {
        maven { url 'https://jitpack.io' }
    }

Add the dependency

    implementation 'com.github.AsynctaskCoffee:VideoLayout:1.1'

Latest Updates

14.07.2020 - AndroidX migration und code refactor

I hope you liked VideoLayout library. You can reach complete code on GitHub!

OSM Android Offline Map Library

EGEMEN — Tue, 04 Aug 2020 10:56:02 +0000

Offline OpenStreet Map Library (No Internet Required) You dont have to even one-time connect!

Offline OpenStreetMap Library

Performance friendly and scalable

Why this project exists

Offline map usage is kind a problem for developers and there are rare documentations. I believe this library will helpful for developers.

Features and Usage

Implementation

Add it in your root build.gradle at the end of repositories

    repositories {
        maven { url 'https://jitpack.io' }
    }

Add the dependency

    implementation 'com.github.AsynctaskCoffee:AndroidOfflineMapLibrary:v1'
    implementation 'com.github.MKergall:osmbonuspack:6.6.0'
    implementation 'org.osmdroid:osmdroid-android:6.1.0'

You need to download offline map-tiles as SQLite format. And you should put it under assets folder. Let me explain how to download offline map-tiles step-by-step;

1. First you need to download Mobile Atlas Creator from HERE

2. Open MOBAC and select Osmdroid SQLite

3. Select map source (selecting osm is better) and zoom-levels (15-14-13-12 are ideal) as you desire from left panel.

4. Draw a area (small areas consume less storage). And press add selection button from left panel.

5. As you can see layers are selected. After selecting layers press Create Atlas button.

6. Select 'Ignore download errors and continue automatically' and continue.

7. After finishing download process rename the SQLite file as 'map.sqlite' and copy it into assets folder.

8. And yes! You completed the hard part. Rest of the steps just coding few lines.

Java

public class MainActivity extends AppCompatActivity implements MapListener, GeoPointListener {

    OfflineMapView offlineMapView;
    MapUtils mapUtils;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        offlineMapView = findViewById(R.id.map);
        offlineMapView.init(this, this);
    }


    @Override
    public void mapLoadSuccess(MapView mapView, MapUtils mapUtils) {

        // GeoPoint belongs to ISTANBUL heart of the world :)
        this.mapUtils = mapUtils;
        offlineMapView.setInitialPositionAndZoom(new GeoPoint(41.025135, 28.974101), 14.5);

        // 41.025135, 28.974101 Galata Tower

        Marker marker = new Marker(mapView);
        marker.setPosition(new GeoPoint(41.025135, 28.974101));
        marker.setIcon(getResources().getDrawable(R.drawable.galata_tower));

        // marker.setImage(drawable);

        marker.setTitle("Hello Istanbul");
        marker.showInfoWindow();
        mapView.getOverlays().add(marker);
        mapView.invalidate();
    }

    @Override
    public void mapLoadFailed(String ex) {
        Log.e("ex:", ex);
    }

    @Override
    public void onGeoPointRecieved(GeoPoint geoPoint) {

        //Selected GeoPoint Returns Here

        Toast.makeText(this, geoPoint.toDoubleString(), Toast.LENGTH_SHORT).show();
    }

    public void activateAnimatePicker(View view) {
        if (mapUtils != null)
            offlineMapView.setAnimatedLocationPicker(true, this, mapUtils);
    }
}

Kotlin

class MainActivityKotlin : AppCompatActivity(), MapListener, GeoPointListener {

    lateinit var offlineMapView: OfflineMapView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main_kotlin)
        offlineMapView = findViewById(R.id.map)
        offlineMapView.init(this, this)
    }

    @SuppressLint("ShowToast")
    override fun onGeoPointRecieved(geoPoint: GeoPoint?) {

        //Selected GeoPoint Returns Here

        Toast.makeText(this, geoPoint?.toDoubleString(), Toast.LENGTH_SHORT).show()
    }

    override fun mapLoadSuccess(mapView: MapView?, mapUtils: MapUtils?) {

        // GeoPoint belongs to ISTANBUL heart of the world :)

        offlineMapView.setInitialPositionAndZoom(GeoPoint(41.011099, 28.996885), 15.5)
        offlineMapView.setAnimatedLocationPicker(true, this, mapUtils)


    }

    override fun mapLoadFailed(ex: String?) {
        Log.e("ex", ex.orEmpty())
    }
}

Or XML

<egolabsapps.basicodemine.offlinemap.Views.OfflineMapView
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:initialFocusLatitude="41.025818"
        app:initialFocusLongitude="28.973436"
        app:zoomLevel="15" />

Forem: EGEMEN

How to Share a Library on JitPack (Android)

Step 1: Create an Android Module

Step 2: Share the Project on GitHub

Step 3: Create a Library Version on GitHub

Step 4: Share Your Library on JitPack

Personal Growth and Contribution in Open-Source Projects

TinderLike Cards - Android

TinderLike Cards ♀️♂️

Why this project exists

Features

Let's Start 🚀

Define CardContainer in you main.xml

Setting CardContainerAdapter with your custom model

Setting Adapter

Before setting the adapter, you can set margin values and the number of visible stacks. The number of cards on the screen will be renewed according to the maxStackSize.

So why should I define these layouts as extra ❓😿 Because in card dragging operations, parent view cordinates are taken as basis. It is necessary to do this so that the dragged card does not conflict with the parent view.

How to listen cardEvents? Here is CardListener and it's usage 🎉

What if I have pagination system for models or need to add more cards later ❓😿 Here is the solution 🎉

Can I throw cards left or right programmatically ❓🤔 Hmmm, YES YOU CAN ❗

Implementation Gradle

Add it in your root build.gradle at the end of repositories

Add the dependency

Implementation Maven

Add the JitPack repository to your build file

Add the dependency

And please dont forget to star :)

Blurr - Easy Blur and Tools Library

Blurr 🌁 Easy Blur and Tools Library

Features

General Usage

Convert Drawable to Blurred Bitmap (async)

Convert Drawable to Blurred Bitmap (sync)

Convert View Blurred Bitmap (async)

Convert View Blurred Bitmap (sync)

Convert Bitmap to Blurred Bitmap (async)

Convert Bitmap to Blurred Bitmap (sync)

Tools: Bitmap From Custom Views

Tools: Bitmap From Drawable

Implementation Gradle

Add it in your root build.gradle at the end of repositories

Add the dependency

Implementation Maven

Add the JitPack repository to your build file

Add the dependency

Android VideoLayout Library

Why this project exists

Features and Usage

Easy implementation

You should put your mp4 files into assets folder, If you use URL you should declare

Implementation

Add it in your root build.gradle at the end of repositories

Add the dependency

Latest Updates

OSM Android Offline Map Library

Why this project exists

Features and Usage

Implementation

Add it in your root build.gradle at the end of repositories

Add the dependency

1. First you need to download Mobile Atlas Creator from HERE

2. Open MOBAC and select Osmdroid SQLite

3. Select map source (selecting osm is better) and zoom-levels (15-14-13-12 are ideal) as you desire from left panel.

4. Draw a area (small areas consume less storage). And press add selection button from left panel.

5. As you can see layers are selected. After selecting layers press Create Atlas button.

6. Select 'Ignore download errors and continue automatically' and continue.

7. After finishing download process rename the SQLite file as 'map.sqlite' and copy it into assets folder.

8. And yes! You completed the hard part. Rest of the steps just coding few lines.

Java

Kotlin

Or XML

Result: Say Hi to ISTANBUL :)