RecyclerView integration

platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/maps/MapView.java

@@ -89,6 +89,7 @@ public class MapView extends FrameLayout implements NativeMapView.ViewCallback {
   private MapKeyListener mapKeyListener;
   @Nullable
   private Bundle savedInstanceState;
+  private boolean isStarted;
 
   @UiThread
   public MapView(@NonNull Context context) {
@@ -345,8 +346,11 @@ public void onSaveInstanceState(@NonNull Bundle outState) {
    */
   @UiThread
   public void onStart() {
-    ConnectivityReceiver.instance(getContext()).activate();
-    FileSource.getInstance(getContext()).activate();
+    if (!isStarted) {
+      ConnectivityReceiver.instance(getContext()).activate();
+      FileSource.getInstance(getContext()).activate();
+      isStarted = true;
+    }
     if (mapboxMap != null) {
       mapboxMap.onStart();
     }
@@ -391,8 +395,11 @@ public void onStop() {
       mapRenderer.onStop();
     }
 
-    ConnectivityReceiver.instance(getContext()).deactivate();
-    FileSource.getInstance(getContext()).deactivate();
+    if (isStarted) {
+      ConnectivityReceiver.instance(getContext()).deactivate();
+      FileSource.getInstance(getContext()).deactivate();
+      isStarted = false;
+    }
   }
 
   /**

platform/android/MapboxGLAndroidSDKTestApp/src/main/AndroidManifest.xml

@@ -872,7 +872,28 @@
                 android:name="android.support.PARENT_ACTIVITY"
                 android:value=".activity.FeatureOverviewActivity" />
         </activity>
-
+        <activity
+                android:name=".activity.maplayout.RecyclerViewActivity"
+                android:description="@string/description_recyclerview"
+                android:label="@string/activity_recyclerview">
+            <meta-data
+                    android:name="@string/category"
+                    android:value="@string/category_maplayout" />
+            <meta-data
+                    android:name="android.support.PARENT_ACTIVITY"
+                    android:value=".activity.FeatureOverviewActivity" />
+        </activity>
+        <activity
+                android:name=".activity.fragment.NestedViewPagerActivity"
+                android:description="@string/description_recyclerview"
+                android:label="@string/activity_nested_viewpager">
+            <meta-data
+                    android:name="@string/category"
+                    android:value="@string/category_fragment" />
+            <meta-data
+                    android:name="android.support.PARENT_ACTIVITY"
+                    android:value=".activity.FeatureOverviewActivity" />
+        </activity>
         <!-- For Instrumentation tests -->
         <activity
             android:name=".activity.style.RuntimeStyleTestActivity"

platform/android/MapboxGLAndroidSDKTestApp/src/main/java/com/mapbox/mapboxsdk/testapp/activity/fragment/NestedViewPagerActivity.kt

@@ -0,0 +1,162 @@
+package com.mapbox.mapboxsdk.testapp.activity.fragment
+
+import android.annotation.SuppressLint
+import android.os.Bundle
+import android.support.v4.app.Fragment
+import android.support.v4.app.FragmentManager
+import android.support.v4.app.FragmentStatePagerAdapter
+import android.support.v4.view.ViewPager
+import android.support.v7.app.AppCompatActivity
+import android.support.v7.widget.LinearLayoutManager
+import android.support.v7.widget.RecyclerView
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import com.mapbox.mapboxsdk.camera.CameraPosition
+import com.mapbox.mapboxsdk.constants.Style
+import com.mapbox.mapboxsdk.geometry.LatLng
+import com.mapbox.mapboxsdk.maps.MapboxMapOptions
+import com.mapbox.mapboxsdk.maps.SupportMapFragment
+import com.mapbox.mapboxsdk.testapp.R
+import kotlinx.android.synthetic.main.activity_recyclerview.*
+
+/**
+ * TestActivity showcasing how to integrate a MapView in a RecyclerView.
+ * <p>
+ * It requires calling the correct lifecycle methods when detaching and attaching the View to
+ * the RecyclerView with onViewAttachedToWindow and onViewDetachedFromWindow.
+ * </p>
+ */
+@SuppressLint("ClickableViewAccessibility")
+class NestedViewPagerActivity : AppCompatActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_recyclerview)
+        recyclerView.layoutManager = LinearLayoutManager(this)
+        recyclerView.adapter = ItemAdapter(LayoutInflater.from(this), supportFragmentManager)
+    }
+
+    class ItemAdapter(private val inflater: LayoutInflater, private val fragmentManager: FragmentManager) : RecyclerView.Adapter<RecyclerView.ViewHolder>() {
+
+        private val items = listOf(
+                "one", "two", "three", ViewPagerItem(), "four", "five", "six", "seven", "eight", "nine", "ten",
+                "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen",
+                "nineteen", "twenty", "twenty-one"
+        )
+
+        private var mapHolder: ViewPagerHolder? = null
+
+        companion object {
+            const val TYPE_VIEWPAGER = 0
+            const val TYPE_TEXT = 1
+        }
+
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
+            return if (viewType == TYPE_VIEWPAGER) {
+                val viewPager = inflater.inflate(R.layout.item_viewpager, parent, false) as ViewPager
+                mapHolder = ViewPagerHolder(viewPager, fragmentManager)
+                return mapHolder as ViewPagerHolder
+            } else {
+                TextHolder(inflater.inflate(android.R.layout.simple_list_item_1, parent, false) as TextView)
+            }
+        }
+
+        override fun getItemCount(): Int {
+            return items.count()
+        }
+
+        override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
+            if (holder.itemViewType == TYPE_TEXT) {
+                val textHolder = holder as TextHolder
+                textHolder.bind(items[position] as String)
+            }
+        }
+
+        override fun getItemViewType(position: Int): Int {
+            return if (items[position] is ViewPagerItem) {
+                TYPE_VIEWPAGER
+            } else {
+                TYPE_TEXT
+            }
+        }
+
+        class TextHolder(val textView: TextView) : RecyclerView.ViewHolder(textView) {
+            fun bind(item: String) {
+                textView.text = item
+            }
+        }
+
+        class ViewPagerItem
+        class ViewPagerHolder(private val viewPager: ViewPager, fragmentManager: FragmentManager) : RecyclerView.ViewHolder(viewPager) {
+            init {
+                viewPager.adapter = MapPagerAdapter(fragmentManager)
+                viewPager.setOnTouchListener { view, motionEvent ->
+                    // Disallow the touch request for recyclerView scroll
+                    view.parent.requestDisallowInterceptTouchEvent(true)
+                    viewPager.onTouchEvent(motionEvent)
+                    false
+                }
+            }
+        }
+
+        class MapPagerAdapter(fm: FragmentManager?) : FragmentStatePagerAdapter(fm) {
+
+            override fun getItem(position: Int): Fragment {
+                val options = MapboxMapOptions()
+                options.textureMode(true)
+                options.doubleTapGesturesEnabled(false)
+                options.rotateGesturesEnabled(false)
+                options.tiltGesturesEnabled(false)
+                options.scrollGesturesEnabled(false)
+                options.zoomGesturesEnabled(false)
+                when (position) {
+                    0 -> {
+                        options.styleUrl(Style.MAPBOX_STREETS)
+                        options.camera(CameraPosition.Builder().target(LatLng(34.920526, 102.634774)).zoom(3.0).build())
+                        return SupportMapFragment.newInstance(options)
+                    }
+                    1 -> {
+                        return EmptyFragment.newInstance()
+                    }
+                    2 -> {
+                        options.styleUrl(Style.DARK)
+                        options.camera(CameraPosition.Builder().target(LatLng(62.326440, 92.764913)).zoom(3.0).build())
+                        return SupportMapFragment.newInstance(options)
+                    }
+                    3 -> {
+                        return EmptyFragment.newInstance()
+                    }
+                    4 -> {
+                        options.styleUrl(Style.SATELLITE)
+                        options.camera(CameraPosition.Builder().target(LatLng(-25.007786, 133.623852)).zoom(3.0).build())
+                        return SupportMapFragment.newInstance(options)
+                    }
+                    5 -> {
+                        return EmptyFragment.newInstance()
+                    }
+                }
+                throw IllegalAccessError()
+            }
+
+            override fun getCount(): Int {
+                return 6
+            }
+        }
+
+        class EmptyFragment : Fragment() {
+            companion object {
+                fun newInstance(): EmptyFragment {
+                    return EmptyFragment()
+                }
+            }
+
+            override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
+                val textView = TextView(inflater.context)
+                textView.text = "This is an empty Fragment"
+                return textView
+            }
+        }
+    }
+}

platform/android/MapboxGLAndroidSDKTestApp/src/main/java/com/mapbox/mapboxsdk/testapp/activity/maplayout/RecyclerViewActivity.kt

@@ -0,0 +1,148 @@
+package com.mapbox.mapboxsdk.testapp.activity.maplayout
+
+import android.annotation.SuppressLint
+import android.os.Bundle
+import android.support.v7.app.AppCompatActivity
+import android.support.v7.widget.LinearLayoutManager
+import android.support.v7.widget.RecyclerView
+import android.view.LayoutInflater
+import android.view.ViewGroup
+import android.widget.TextView
+import com.mapbox.mapboxsdk.maps.MapView
+import com.mapbox.mapboxsdk.testapp.R
+import kotlinx.android.synthetic.main.activity_recyclerview.*
+
+/**
+ * TestActivity showcasing how to integrate a MapView in a RecyclerView.
+ * <p>
+ * It requires calling the correct lifecycle methods when detaching and attaching the View to
+ * the RecyclerView with onViewAttachedToWindow and onViewDetachedFromWindow.
+ * </p>
+ */
+@SuppressLint("ClickableViewAccessibility")
+class RecyclerViewActivity : AppCompatActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_recyclerview)
+        recyclerView.layoutManager = LinearLayoutManager(this)
+        recyclerView.adapter = ItemAdapter(LayoutInflater.from(this), savedInstanceState)
+    }
+
+    override fun onSaveInstanceState(outState: Bundle?) {
+        super.onSaveInstanceState(outState)
+        // to save state, we need to call MapView#onSaveInstanceState
+        (recyclerView.adapter as ItemAdapter).onSaveInstanceState(outState)
+    }
+
+    override fun onLowMemory() {
+        super.onLowMemory()
+        // to release memory, we need to call MapView#onLowMemory
+        (recyclerView.adapter as ItemAdapter).onLowMemory()
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        // to perform cleanup, we need to call MapView#onDestroy
+        (recyclerView.adapter as ItemAdapter).onDestroy()
+    }
+
+    class ItemAdapter(private val inflater: LayoutInflater, val savedInstanceState: Bundle?) : RecyclerView.Adapter<RecyclerView.ViewHolder>() {
+
+        private val items = listOf(
+                "one", "two", "three", MapItem(), "four", "five", "six", "seven", "eight", "nine", "ten",
+                "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen",
+                "nineteen", "twenty", "twenty-one"
+        )
+
+        private var mapHolder: MapHolder? = null
+
+        companion object {
+            const val TYPE_MAP = 0
+            const val TYPE_TEXT = 1
+        }
+
+        override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
+            return if (viewType == TYPE_MAP) {
+                val mapView = inflater.inflate(R.layout.item_map, parent, false) as MapView
+                mapHolder = MapHolder(mapView, savedInstanceState)
+                return mapHolder as MapHolder
+            } else {
+                TextHolder(inflater.inflate(android.R.layout.simple_list_item_1, parent, false) as TextView)
+            }
+        }
+
+        override fun onViewAttachedToWindow(holder: RecyclerView.ViewHolder) {
+            super.onViewAttachedToWindow(holder)
+            if (holder is MapHolder) {
+                val mapView = holder.mapView
+                mapView.onStart()
+                mapView.onResume()
+            }
+        }
+
+        override fun onViewDetachedFromWindow(holder: RecyclerView.ViewHolder) {
+            super.onViewDetachedFromWindow(holder)
+            if (holder is MapHolder) {
+                val mapView = holder.mapView
+                mapView.onPause()
+                mapView.onStop()
+            }
+        }
+
+        override fun getItemCount(): Int {
+            return items.count()
+        }
+
+        override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
+            if (holder.itemViewType == TYPE_TEXT) {
+                val textHolder = holder as TextHolder
+                textHolder.bind(items[position] as String)
+            }
+        }
+
+        override fun getItemViewType(position: Int): Int {
+            return if (items[position] is MapItem) {
+                TYPE_MAP
+            } else {
+                TYPE_TEXT
+            }
+        }
+
+        fun onSaveInstanceState(savedInstanceState: Bundle?){
+            savedInstanceState?.let {
+                mapHolder?.mapView?.onSaveInstanceState(it)
+            }
+        }
+
+        fun onLowMemory() {
+            mapHolder?.mapView?.onLowMemory()
+        }
+
+        fun onDestroy() {
+            mapHolder?.mapView?.let {
+                it.onPause()
+                it.onStop()
+                it.onDestroy()
+            }
+        }
+
+        class MapItem
+        class MapHolder(val mapView: MapView, bundle: Bundle?) : RecyclerView.ViewHolder(mapView) {
+            init {
+                mapView.onCreate(bundle)
+                mapView.setOnTouchListener { view, motionEvent ->
+                    // Disallow the touch request for recyclerView scroll
+                    view.parent.requestDisallowInterceptTouchEvent(true)
+                    mapView.onTouchEvent(motionEvent)
+                    true
+                }
+            }
+        }
+        class TextHolder(val textView: TextView) : RecyclerView.ViewHolder(textView) {
+            fun bind(item: String) {
+                textView.text = item
+            }
+        }
+    }
+}

platform/android/MapboxGLAndroidSDKTestApp/src/main/res/layout/activity_recyclerview.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<android.support.constraint.ConstraintLayout
+        xmlns:android="http://schemas.android.com/apk/res/android"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent">
+
+    <android.support.v7.widget.RecyclerView
+            android:id="@+id/recyclerView"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent" />
+
+</android.support.constraint.ConstraintLayout>