Documentation reference maplibre

.gitignore

@@ -14,7 +14,7 @@ build/
 
 ### Code gen activity sanity tests ###
 /node_modules
-app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/gen
+app/src/androidTest/java/org/maplibre/android/plugins/gen
 
 ### Code gen annotation plugin ###
 plugin-annotation/scripts/code-gen.list

CONTRIBUTING.md

@@ -1,33 +1,16 @@
 # Contributing
 
-We welcome contributions to this plugin repository. If you're interested in building and sharing your own, please follow these steps:
+We welcome contributions to this plugin repository. Please be aware that all plugins, except Annotations, are not actively maintained. If you are interested in becoming a maintainer for a plugin feel free to submit a pull request with a short introduction and your name and GitHub handle in the respective README.
+
+If you're interested in building and sharing your own plugin, please follow these steps:
 
 - [Open a ticket](https://github.com/maplibre/maplibre-plugins-android/issues/new) to kick off a conversation. It's a good idea to explain your plans before you push any code to make sure noone else is working on something similar and to discuss the best approaches to tackle your particular idea.
 
 - Create a new branch that will contain the code for your plugin.
 
-- Create a new Android library module inside the `plugins` project with Android Studio. Each plugin is a separate library that depends on the Mapbox Android SDK, and potentially on other third-party libraries. Besides the code for the plugin, make sure you include:
+- Create a new Android library module inside the `plugins` project with Android Studio. Each plugin is a separate library that depends on the MapLibre Android SDK, and potentially on other third-party libraries. Besides the code for the plugin, make sure you include:
 
   - Tests.
   - Javadoc that documents the plugin usage and purpose in detail.
 
-- Create a new activity inside the demo app that showcases how to use your plugin. As important as having a working plugin is to show how to use it so that anyone can include it in their projects easily.
-
-- Finally, once you're ready to share your code, list your plugin in this file and then open a PR for the `@mapbox/android` team to review.
-
-## Adding or updating a localization
-
-The Mapbox Plugins SDK for Android features several translations contributed through [Transifex](https://www.transifex.com/mapbox/mapbox-plugins-android/). If your language already has a translation, feel free to complete or proofread it. Otherwise, please [request your language](https://www.transifex.com/mapbox/mapbox-plugins-android/) so you can start translating. Note that we’re primarily interested in languages that Android supports as system languages.
-
-While you’re there, please consider also translating the following related projects:
-
-* [OSRM Text Instructions](https://www.transifex.com/project-osrm/osrm-text-instructions/), which the Mapbox Directions API uses to generate textual and verbal turn instructions ([instructions](https://github.com/Project-OSRM/osrm-text-instructions/blob/master/CONTRIBUTING.md#adding-or-updating-a-localization)).
-* [Mapbox Navigation SDK for iOS](https://www.transifex.com/mapbox/mapbox-navigation-ios/), the analogous library for iOS applications ([instructions](https://github.com/mapbox/mapbox-navigation-ios/blob/main/CONTRIBUTING.md#adding-or-updating-a-localization)).
-* [Mapbox Maps SDK for Android](https://www.transifex.com/mapbox/mapbox-gl-native/), which is responsible for the map view and minor UI elements such as the Mapbox Telemetry permissions dialog
-
-Once you’ve finished translating the Android Plugins SDK into a new language in Transifex, open an issue in this repository asking to pull in your translations. You can also pull in the translations yourself:
-
-1. Create a new branch that will contain the new translations.
-1. _(First time only.)_ Download the [`tx` command line tool](https://docs.transifex.com/client/installing-the-client) and [configure your .transifexrc](https://docs.transifex.com/client/client-configuration).
-1. Run `tx pull -a` to fetch translations from Transifex. You can restrict the operation to just the new language using `tx pull -l xyz`, where _xyz_ is the language code.
-1. Commit any new files that were added and open a pull request with your changes.
+- Finally, once you're ready to share your code, list your plugin in this file and then open a PR for other contributors to review.

LICENSE

@@ -1,4 +1,5 @@
 Copyright (c) 2019, Mapbox
+Copyright (c) 2023, MapLibre contributors
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

README.md

@@ -1,28 +1,28 @@
 <h1 align="center">
   <br>
-  <a href="https://www.mapbox.com/android-docs/plugins/overview/"><img src="https://github.com/mapbox/mapbox-plugins-android/blob/master/.github/mbx-plugins-logo.png" alt="Mapbox Plugins" width="500"></a>
+  <img src="https://github.com/maplibre/maplibre-plugins-android/blob/master/.github/mlb-plugins-logo.png" alt="MapLibre Plugins" width="500">
 </h1>
 
-<h4 align="center">Plugins are single-purpose libraries built on top of the <a href="https://www.mapbox.com/android-docs/">Mapbox Maps SDK for Android</a> that you can include in your apps like any other Android dependency</h4>
+<h4 align="center">Plugins are single-purpose libraries built on top of the <a href="https://maplibre.org/maplibre-gl-native/android/api/">MapLibre Maps SDK for Android</a> that you can include in your apps like any other Android dependency</h4>
 
 <p align="center">
-  <a href="https://circleci.com/gh/mapbox/mapbox-plugins-android">
-    <img src="https://circleci.com/gh/mapbox/mapbox-plugins-android.svg?style=shield&circle-token=:circle-token">
-  </a>
+  [![ci](https://github.com/maplibre/maplibre-plugins-android/actions/workflows/ci.yml/badge.svg)](https://github.com/maplibre/maplibre-plugins-android/actions/workflows/ci.yml)
 </p>
 <br>
 
 # MapLibre Plugins for Android
 
-Plugins are single-purpose libraries built on top of the [Mapbox Maps SDK for Android](https://www.mapbox.com/android-docs/) that you can include in your apps like any other Android dependency. You'll find [documentation for each plugin on our Android documentation website](https://www.mapbox.com/android-docs/plugins/overview/). A full list of the current plugins is available below.
+Plugins are single-purpose libraries built on top of the [MapLibre GL Native for Android](https://maplibre.org/maplibre-gl-native/android/api/) that you can include in your apps like any other Android dependency. A full list of the current plugins is available below.
+
+We are looking for maintainers for these plugins! Please reach out to the Maplibre team and take a look at [the contribution guide](https://github.com/maplibre/maplibre-plugins-android/blob/master/CONTRIBUTING.md).
 
 ## Available Plugins
- 
+
 * [**Annotation:** Simplify the way to set and adjust the visual properties of annotations on a map.](https://github.com/maplibre/maplibre-plugins-android/tree/master/plugin-annotation)
 
 * [**MarkerView:** Add map markers that are Android views.](https://github.com/maplibre/maplibre-plugins-android/tree/master/plugin-markerview)
- 
-* [**Traffic:** Adds a real-time traffic layer to any Mapbox base map.](https://github.com/maplibre/maplibre-plugins-android/tree/master/plugin-traffic)
+
+* [**Traffic:** Adds a real-time traffic layer to any MapLibre base map.](https://github.com/maplibre/maplibre-plugins-android/tree/master/plugin-traffic)
 
 * [**Location layer:** [Deprecated] Add a location marker on your map indicating the user's location.](https://github.com/maplibre/maplibre-plugins-android/tree/master/plugin-locationlayer)
 
@@ -38,7 +38,7 @@ Plugins are single-purpose libraries built on top of the [Mapbox Maps SDK for An
 
 ## Installing a plugin
 
-By using a plugin, you also have to include the Mapbox Maps SDK for Android which means that you'll need to setup your project to use the Maps SDK if you haven't already. Head over to the [overview page for the Maps SDK](https://www.mapbox.com/android-docs/map-sdk/overview/) to learn more.
+By using a plugin, you also have to include the MapLibre GL Native for Android which means that you'll need to setup your project to use the Maps SDK if you haven't already. Head over to the [overview page for the Maps SDK](https://maplibre.org/projects/maplibre-native/) to learn more.
 
 Note that depending on the plugin you add, there might be required permissions and additional setup steps. You'll find more information on whether or not more configuration steps are involved when looking at the specific plugin documentation.
 
@@ -50,49 +50,41 @@ Note that depending on the plugin you add, there might be required permissions a
 repositories {
   mavenCentral()
   maven {
-    url 'https://api.mapbox.com/downloads/v2/releases/maven'
-    authentication {
-      basic(BasicAuthentication)
-    }
-    credentials {
-      username "mapbox"
-      password = "SDK_REGISTRY_TOKEN"
-    }
+    url 'https://api.maplibre.com/downloads/v2/releases/maven'
   }
 }
 
 dependencies {
-  implementation 'com.mapbox.mapboxsdk:{PLUGIN_NAME}-v{MAJOR_MAPS_SDK_VERSION_NUMBER}:PLUGIN_VERSION_NUMBER'
+  implementation 'org.maplibre.android:{PLUGIN_NAME}-v{MAJOR_MAPS_SDK_VERSION_NUMBER}:PLUGIN_VERSION_NUMBER'
 }
 ```
-5. Replace SDK_REGISTRY_TOKEN with a Mapbox access token that has the downloads scope
 
 Plugin artifacts are versioned based on the major release of the Maps SDK for Android, which means, that each artifact's name has a major version of the Maps SDK it's compatible with appended.
 
 5. Click the Sync Project with Gradle Files near the toolbar in Studio.
 
 ## Maps SDK compatibility
 
-The Mapbox Plugins for Android are heavily dependent on the major semantic versioning number of the Maps SDK. They either won't compile or hide runtime bugs when paired with a different major version of the Maps SDK. Each plugin's dependency name has a `vX` suffix which states the major version of the Maps SDK that the plugin is compatible with. This suffix makes the transition between versions easier and more educated without the need to jump into changelogs and compare repositories.
+The MapLibre Plugins for Android are heavily dependent on the major semantic versioning number of the Maps SDK. They either won't compile or hide runtime bugs when paired with a different major version of the Maps SDK. Each plugin's dependency name has a `vX` suffix which states the major version of the Maps SDK that the plugin is compatible with. This suffix makes the transition between versions easier and more educated without the need to jump into changelogs and compare repositories.
 
 ## Help and Usage
 
-A plugin is simply a library module built on top of the Mapbox Maps SDK for Android. Plugins can be easy to use. Currently, we are not requiring plugins to register themselves or to implement any specific interfaces so that they're simple to consume.
+A plugin is simply a library module built on top of the MapLibre Maps SDK for Android. Plugins can be easy to use. Currently, we are not requiring plugins to register themselves or to implement any specific interfaces so that they're simple to consume.
 
 ### Test app
 
 This repository includes an app with examples showing how you can use each plugin.
-- To access ready-to-use snippets, [see its code here](https://github.com/mapbox/mapbox-plugins-android/tree/master/app/src/main/java/com/mapbox/mapboxsdk/plugins/testapp).
-- To run the application locally, open the [`PluginApplication`](https://github.com/mapbox/mapbox-plugins-android/blob/4ff768983323cc4a57791bcb577639109e4fd9ce/app/src/main/java/com/mapbox/mapboxsdk/plugins/testapp/PluginApplication.kt) file and replace `mapbox_access_token` with your own Mapbox token from [https://account.mapbox.com](https://account.mapbox.com).
+- To access ready-to-use snippets, [see its code here](https://github.com/maplibre/maplibre-plugins-android/tree/master/app/src/main/java/org/maplibre/android/plugins/testapp).
+- To run the application locally, open the [`PluginApplication`](https://github.com/maplibre/maplibre-plugins-android/blob/4ff768983323cc4a57791bcb577639109e4fd9ce/app/src/main/java/org/maplibre/android/plugins/testapp/PluginApplication.kt) file
 
-This might change in the future as we build more plugins and learn how you use them. We'd love to [hear your feedback](https://github.com/mapbox/mapbox-plugins-android/issues).
+This might change in the future as we build more plugins and learn how you use them. We'd love to [hear your feedback](https://github.com/maplibre/maplibre-plugins-android/issues).
 
 ## Why Plugins?
 
 Splitting specific functionality into plugins makes our Maps SDK lighter and nimble for you to use, and it also lets us iterate faster. We can release plugins more often than the SDK, which requires a slower pace due to its larger codebase.
 
-The Mapbox Android team creates plugins but this plugins repository is an open-source project similar to the various Mapbox SDKs for Android.
-Plugins' lightweight nature makes them much easier for you and anyone else to contribute rather than trying to add the same feature to the more robust Maps SDK. The Mapbox team can also more easily accept contributed plugins and keep the plugin list growing.
+The MapLibre Android team creates plugins but this plugins repository is an open-source project similar to the various MapLibre SDKs for Android.
+Plugins' lightweight nature makes them much easier for you and anyone else to contribute rather than trying to add the same feature to the more robust Maps SDK. The MapLibre team can also more easily accept contributed plugins and keep the plugin list growing.
 
 ## Contributing
 

app/build.gradle

@@ -9,7 +9,7 @@ android {
   defaultConfig {
     minSdkVersion androidVersions.minSdkVersion
     targetSdkVersion androidVersions.targetSdkVersion
-    applicationId "com.mapbox.mapboxsdk.plugins.testapp"
+    applicationId "org.maplibre.android.plugins.testapp"
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
     vectorDrawables.useSupportLibrary = true
   }
@@ -111,7 +111,7 @@ dependencies {
   implementation project(':plugin-localization')
   implementation project(':plugin-annotation')
   implementation project(':plugin-markerview')
-  implementation project(':ktx-mapbox-maps')
+  implementation project(':ktx-maplibre-maps')
   implementation project(':plugin-scalebar')
 }
 

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/BaseActivityTest.java → app/src/androidTest/java/org/maplibre/android/plugins/BaseActivityTest.java

@@ -1,14 +1,14 @@
-package com.mapbox.mapboxsdk.plugins;
+package org.maplibre.android.plugins;
 
 import android.app.Activity;
 import android.content.Context;
 import android.net.ConnectivityManager;
 import android.net.NetworkInfo;
 
 import com.mapbox.mapboxsdk.maps.MapboxMap;
-import com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction;
-import com.mapbox.mapboxsdk.plugins.annotation.WaitAction;
-import com.mapbox.mapboxsdk.plugins.utils.OnMapReadyIdlingResource;
+import org.maplibre.android.plugins.annotation.MapboxMapAction;
+import org.maplibre.android.plugins.annotation.WaitAction;
+import org.maplibre.android.plugins.utils.OnMapReadyIdlingResource;
 
 import junit.framework.Assert;
 
@@ -101,4 +101,3 @@ public void afterTest() {
     IdlingRegistry.getInstance().unregister(idlingResource);
   }
 }
-

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/activity.junit.ejs → app/src/androidTest/java/org/maplibre/android/plugins/activity.junit.ejs

@@ -3,12 +3,12 @@
   const subPackage = locals[1];
 -%>
 // This file is generated
-package com.mapbox.mapboxsdk.plugins.gen.<%- subPackage %>;
+package org.maplibre.android.plugins.gen.<%- subPackage %>;
 
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.<%- subPackage %>.<%- activity %>;
+import org.maplibre.android.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.<%- subPackage %>.<%- activity %>;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/annotation/CircleManagerTest.java → app/src/androidTest/java/org/maplibre/android/plugins/annotation/CircleManagerTest.java

@@ -1,20 +1,20 @@
 // This file is generated.
 
-package com.mapbox.mapboxsdk.plugins.annotation;
+package org.maplibre.android.plugins.annotation;
 
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
 import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.TestActivity;
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.TestActivity;
+import org.maplibre.android.plugins.BaseActivityTest;
 import timber.log.Timber;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
 import java.util.Objects;
 
-import static com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction.invoke;
+import static org.maplibre.android.plugins.annotation.MapboxMapAction.invoke;
 import static org.junit.Assert.*;
 import static com.mapbox.mapboxsdk.style.layers.Property.*;
 

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/annotation/CircleTest.java → app/src/androidTest/java/org/maplibre/android/plugins/annotation/CircleTest.java

@@ -1,13 +1,13 @@
 // This file is generated.
 
-package com.mapbox.mapboxsdk.plugins.annotation;
+package org.maplibre.android.plugins.annotation;
 
 import android.graphics.PointF;
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
 import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.TestActivity;
+import org.maplibre.android.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.TestActivity;
 import com.mapbox.mapboxsdk.utils.ColorUtils;
 import timber.log.Timber;
 
@@ -16,7 +16,7 @@
 
 import java.util.Objects;
 
-import static com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction.invoke;
+import static org.maplibre.android.plugins.annotation.MapboxMapAction.invoke;
 import static org.junit.Assert.*;
 import static com.mapbox.mapboxsdk.style.layers.Property.*;
 

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/annotation/FillManagerTest.java → app/src/androidTest/java/org/maplibre/android/plugins/annotation/FillManagerTest.java

@@ -1,20 +1,20 @@
 // This file is generated.
 
-package com.mapbox.mapboxsdk.plugins.annotation;
+package org.maplibre.android.plugins.annotation;
 
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
 import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.TestActivity;
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.TestActivity;
+import org.maplibre.android.plugins.BaseActivityTest;
 import timber.log.Timber;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
 import java.util.Objects;
 
-import static com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction.invoke;
+import static org.maplibre.android.plugins.annotation.MapboxMapAction.invoke;
 import static org.junit.Assert.*;
 import static com.mapbox.mapboxsdk.style.layers.Property.*;
 

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/annotation/FillTest.java → app/src/androidTest/java/org/maplibre/android/plugins/annotation/FillTest.java

@@ -1,13 +1,13 @@
 // This file is generated.
 
-package com.mapbox.mapboxsdk.plugins.annotation;
+package org.maplibre.android.plugins.annotation;
 
 import android.graphics.PointF;
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
 import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.TestActivity;
+import org.maplibre.android.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.TestActivity;
 import com.mapbox.mapboxsdk.utils.ColorUtils;
 import timber.log.Timber;
 
@@ -16,7 +16,7 @@
 
 import java.util.Objects;
 
-import static com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction.invoke;
+import static org.maplibre.android.plugins.annotation.MapboxMapAction.invoke;
 import static org.junit.Assert.*;
 import static com.mapbox.mapboxsdk.style.layers.Property.*;
 

app/src/androidTest/java/com/mapbox/mapboxsdk/plugins/annotation/LineManagerTest.java → app/src/androidTest/java/org/maplibre/android/plugins/annotation/LineManagerTest.java

@@ -1,20 +1,20 @@
 // This file is generated.
 
-package com.mapbox.mapboxsdk.plugins.annotation;
+package org.maplibre.android.plugins.annotation;
 
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 
 import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.plugins.testapp.activity.TestActivity;
-import com.mapbox.mapboxsdk.plugins.BaseActivityTest;
+import org.maplibre.android.plugins.testapp.activity.TestActivity;
+import org.maplibre.android.plugins.BaseActivityTest;
 import timber.log.Timber;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 
 import java.util.Objects;
 
-import static com.mapbox.mapboxsdk.plugins.annotation.MapboxMapAction.invoke;
+import static org.maplibre.android.plugins.annotation.MapboxMapAction.invoke;
 import static org.junit.Assert.*;
 import static com.mapbox.mapboxsdk.style.layers.Property.*;