Merge pull request commons-app#58 from RitikaPahwa4444/get_content_photo_picker

GET_CONTENT photo picker details

Author: nicolas-raoul

docs.html

@@ -105,7 +105,82 @@ <h2 id="getting-app-logs-from-android-studio"><a href="#getting-app-logs-from-an
         </ol>
 
         <h2 id="get-content"><a href="#get-content">What is GET_CONTENT?</a></h2>
-        <p>TODO</p>
+        <p>The normal selector now has two variants: the classic picker and the GET_CONTENT picker (you may choose your favourite variant from Settings). The custom selector still remains the same. The app now has 3 pickers:</p>
+        <p>
+            <ul>
+                <li>The classic picker that you may use in the Contributions and Nearby tab</li>
+                <center>
+                    <figure>
+                         <img src="images/classic_picker.png" height="400">
+                         <figcaption>Classic Picker</figcaption>
+                     </figure>
+                </center>
+                <li>The custom picker that you may use in the Contributions tab</li>
+                <center>
+                    <figure>
+                         <img src="images/custom_picker.jpeg" height="400">
+                         <figcaption>Custom Picker</figcaption>
+                     </figure>
+                </center>
+                <li>The GET_CONTENT picker that you may try in the Contributions and Nearby tab
+                    <p>The GET_CONTENT picker varies from device to device:</p>
+                    <center>
+                        <figure>
+                            <img src="images/get_content_picker_without_takeover.png" height="400">
+                            <figcaption>GET_CONTENT picker without takeover</figcaption>
+                        </figure>
+                        <figure>
+                            <img src="images/get_content_picker_with_takeover.png" height="460">
+                            <figcaption>GET_CONTENT picker with takeover</figcaption>
+                        </figure>
+                    </center>
+                </li>
+            </ul>
+        </p>
+
+        <h4>How is the new GET_CONTENT picker different from the classic picker?</h4>
+        <p>Android recently introduced a new photo picker for devices having Android 11 or higher. Unfortunately, this photo picker removes location tags from the EXIF metadata of images. The new photo picker takes over GET_CONTENT on some devices. This means you will see the new photo picker and your pictures might lose location information in the EXIF metadata.</p> 
+        <p>In order to preserve location information, we decided to go with the system file picker by default for the classic picker and disabled the GET_CONTENT picker.</p>
+        
+        <p>To summarize the advantages and disadvantages:</p>
+
+        <p><b>GET_CONTENT Picker:</b>
+            <ul>
+                <li><b>Merits:</b> Lists all image providers as marked in red in the figure above, user-friendly interface.</li>
+                <li><b>Demerit:</b> Removes location tags from EXIF metadata on some devices.</li>
+            </ul>
+        </p>
+        <p><b>Classic Picker:</b>
+            <ul>
+                <li><b>Merit:</b> Preserves location tags on all devices.</li>
+                <li><b>Demerit:</b> Only allows selection from within the app and Google Drive, no third-party image providers displayed.</li>
+            </ul>
+        </p>
+        <p>You may like to use the classic picker when:</p>
+        <ul>
+            <li>You want to share the location information present in the EXIF metadata of the images</li>
+            <li>You choose images from within the file picker and do not use any other Gallery app providers</li>
+        </ul>
+        <p>You may like to use the GET_CONTENT picker when:</p>
+        <ul>
+            <li>You love sharing images from third-party Gallery apps and other such providers and prefer the existing UI</li>
+            <li>You are using a device in which the new photo picker does not take over GET_CONTENT</li>
+            <li>You do not wish to share the location information in the EXIF metadata in case GET_CONTENT takeover is enabled on your device.</li>
+        </ul>
+
+        <h4>Can we enjoy the GET_CONTENT picker without takeover?</h4>
+        <p>Absolutely yes! You can easily disable the GET_CONTENT takeover on your device by running a simple command. This will enable the app to display all image providers, allowing you to use them within the app.</p>
+        <p>To run the adb command, follow these steps:</p>
+        <ol>
+            <li>Enable developer options and USB debugging on your phone.</li>
+            <li>Connect your phone to your computer using a USB cable.</li>
+            <li>Open the terminal on your computer.</li>
+            <li>To ensure that your phone is connected to the adb server, run the following command:</li>
+            <pre><code>adb devices -l</code></pre>
+            <li>Once you have confirmed the connection, execute the following command to disable the takeover:</li>
+            <pre><code>adb shell cmd device_config put storage_native_boot take_over_get_content false</code></pre>
+        </ol>
+        <p>Now you can easily access all the image providers without losing picture locations by using the GET_CONTENT picker!</p>
 
         <p align="right"><i><a href="https://github.com/commons-app/commons-app.github.io/blob/master/docs.html">Edit this page</a></i></p>
     </div>