Added URL share

Author: deckameron

README.md

@@ -12,7 +12,8 @@ This module solves a critical limitation in Titanium SDK when sharing images on
 
 ## Features
 
-- Share images from Resources, Blobs, or file paths
+- Share images from URLs, Resources, Blobs, or file paths
+- Automatic image download from remote URLs
 - Automatic FileProvider URI generation
 - Support for text and image combination sharing
 - Optional callback to handle share results (success, cancelled, or error)
@@ -90,6 +91,18 @@ imageView.addEventListener('load', function() {
 });
 ```
 
+### Share image from URL
+
+The module will automatically download the image in the background before sharing. If the download fails, it will share text only (or notify via callback if provided).
+
+```javascript
+ShareModule.share({
+    message: "Check out this amazing photo!",
+    subject: "Photo from the web",
+    image: "https://www.example.com/photos/sunset.jpg"
+});
+```
+
 ### Share text only
 
 ```javascript
@@ -132,6 +145,7 @@ Opens the Android share dialog with the specified content.
   - `message` (String, optional): Text content to share
   - `subject` (String, optional): Subject line for sharing (used by email apps)
   - `image` (String|TiBlob, optional): Image to share. Can be:
+    - **URL** (e.g., `"https://example.com/photo.jpg"`) - Will be downloaded automatically
     - Path to resource file (e.g., `/images/photo.jpg`)
     - Path from applicationDataDirectory
     - TiBlob object (from `imageView.toBlob()`, camera, etc.)
@@ -165,26 +179,41 @@ ShareModule.share({
 
 The module handles the following automatically:
 
-1. **Resource location**: Attempts to find images in multiple locations:
+1. **URL Detection**: Automatically detects if the image parameter is a URL (starts with `http://` or `https://`)
+
+2. **Image Download**: For URL images:
+   - Downloads the image asynchronously in the background
+   - Uses a 15-second timeout for connection and read operations
+   - Saves to the cache directory
+   - If download fails, shares text only or notifies via callback
+
+3. **Resource location**: For local files, attempts to find images in multiple locations:
    - Application resources (`/app/_app_/Resources/`)
    - Android assets
    - Application data directory
    - Cache directory
 
-2. **File preparation**: For resource files and Blobs:
+4. **File preparation**: For resource files and Blobs:
    - Copies the file to the cache directory
    - Ensures the file is accessible by the FileProvider
 
-3. **URI generation**: Creates a secure `content://` URI using Android's FileProvider
+5. **URI generation**: Creates a secure `content://` URI using Android's FileProvider
 
-4. **Permission granting**: Adds `FLAG_GRANT_READ_URI_PERMISSION` so receiving apps can access the file
+6. **Permission granting**: Adds `FLAG_GRANT_READ_URI_PERMISSION` so receiving apps can access the file
 
-5. **Intent creation**: Builds a proper `ACTION_SEND` intent with all necessary flags
+7. **Intent creation**: Builds a proper `ACTION_SEND` intent with all necessary flags
 
-6. **Result handling**: When a callback is provided, uses `startActivityForResult` to capture the share outcome and notify your application
+8. **Result handling**: When a callback is provided, uses `startActivityForResult` to capture the share outcome and notify your application
 
 ## Troubleshooting
 
+### URL image download issues
+
+If images from URLs fail to download:
+
+- Ensure the URL is publicly accessible (not behind authentication)
+- Check that the URL points directly to an image file (ends in .jpg, .png, etc.)
+
 ### Callback not firing
 
 The callback relies on Android's activity result system. Note that:
@@ -211,8 +240,15 @@ Ensure:
 - Your app has necessary permissions in `tiapp.xml`:
 
 ```xml
-<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
-<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
+<!-- Necessária APENAS se você ler imagens de locais externos ao cache -->
+<!-- Only needed if you read images from external sources or cache -->
+<!-- Android 6 to 12 -->
+<uses-permission 
+    android:name="android.permission.READ_EXTERNAL_STORAGE"
+    android:maxSdkVersion="32"/>
+
+<!-- Android 13+ (replaced READ_EXTERNAL_STORAGE) -->
+<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
 ```
 
 ## Contributing

android/dist/ti.android.share-android-1.0.0.zip

@@ -2,7 +2,7 @@
 # this is your module manifest and used by Titanium
 # during compilation, packaging, distribution, etc.
 #
-version: 1.0.0
+version: 1.0.1
 apiversion: 4
 architectures: arm64-v8a armeabi-v7a x86 x86_64
 description: ti.android.share

android/dist/ti.android.share-android-1.0.1.zip

@@ -3,6 +3,7 @@
 import android.app.Activity;
 import android.content.Intent;
 import android.net.Uri;
+import android.os.AsyncTask;
 import androidx.core.content.FileProvider;
 import org.appcelerator.kroll.KrollDict;
 import org.appcelerator.kroll.KrollFunction;
@@ -16,6 +17,9 @@
 import org.appcelerator.titanium.util.TiActivitySupport;
 import java.io.File;
 import java.io.FileOutputStream;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URL;
 import java.util.HashMap;
 
 public class ShareProxy implements TiActivityResultHandler {
@@ -35,7 +39,7 @@ public static void share(HashMap params, KrollModule module) {
     private void executeShare(HashMap params) {
         try {
             String message = TiConvert.toString(params.get("message"), "");
-            String subject = TiConvert.toString(params.get("subject"), "Compartilhar");
+            String subject = TiConvert.toString(params.get("subject"), "Share");
             Object imageObj = params.get("image");
             Object callbackObj = params.get("callback");
 
@@ -49,6 +53,35 @@ private void executeShare(HashMap params) {
             Log.d(TAG, "Image object type: " + (imageObj != null ? imageObj.getClass().getName() : "null"));
             Log.d(TAG, "Callback provided: " + (this.callback != null));
 
+            // Check if image is a URL
+            if (imageObj instanceof String && isUrl((String) imageObj)) {
+                String imageUrl = (String) imageObj;
+                Log.d(TAG, "Detected URL image: " + imageUrl);
+
+                // Download image asynchronously
+                new ImageDownloadTask(message, subject).execute(imageUrl);
+
+            } else {
+                // Process normally (local file or blob)
+                processShare(message, subject, imageObj);
+            }
+
+        } catch (Exception e) {
+            Log.e(TAG, "FATAL ERROR while sharing: " + e.getMessage(), e);
+
+            // Call callback with error if available
+            if (this.callback != null) {
+                fireCallback(false, "Error: " + e.getMessage());
+            }
+        }
+    }
+
+    private boolean isUrl(String str) {
+        return str != null && (str.startsWith("http://") || str.startsWith("https://"));
+    }
+
+    private void processShare(String message, String subject, Object imageObj) {
+        try {
             Intent shareIntent = new Intent(Intent.ACTION_SEND);
 
             if (imageObj != null) {
@@ -97,9 +130,8 @@ private void executeShare(HashMap params) {
             Log.d(TAG, "=== SHARE INITIATED ===");
 
         } catch (Exception e) {
-            Log.e(TAG, "FATAL ERROR while sharing: " + e.getMessage(), e);
+            Log.e(TAG, "ERROR in processShare: " + e.getMessage(), e);
 
-            // Call callback with error if available
             if (this.callback != null) {
                 fireCallback(false, "Error: " + e.getMessage());
             }
@@ -173,6 +205,12 @@ private static Uri getImageUri(Object imageObj) {
                 fos.close();
 
                 Log.d(TAG, "File created successfully. Size: " + imageFile.length() + " bytes");
+
+            }
+            // If it's a File object (already downloaded from URL)
+            else if (imageObj instanceof File) {
+                imageFile = (File) imageObj;
+                Log.d(TAG, "Using existing File object: " + imageFile.getAbsolutePath());
             }
             // If it's a file path (String)
             else if (imageObj instanceof String) {
@@ -281,4 +319,100 @@ else if (imageObj instanceof String) {
 
         return null;
     }
+
+    /**
+     * AsyncTask to download image from URL in background
+     */
+    private class ImageDownloadTask extends AsyncTask<String, Void, File> {
+
+        private String message;
+        private String subject;
+        private String errorMessage;
+
+        public ImageDownloadTask(String message, String subject) {
+            this.message = message;
+            this.subject = subject;
+        }
+
+        @Override
+        protected File doInBackground(String... urls) {
+            String imageUrl = urls[0];
+            HttpURLConnection connection = null;
+
+            try {
+                Log.d(TAG, "Starting image download from: " + imageUrl);
+
+                URL url = new URL(imageUrl);
+                connection = (HttpURLConnection) url.openConnection();
+                connection.setConnectTimeout(15000);
+                connection.setReadTimeout(15000);
+                connection.setRequestMethod("GET");
+                connection.setDoInput(true);
+                connection.connect();
+
+                int responseCode = connection.getResponseCode();
+                Log.d(TAG, "Response code: " + responseCode);
+
+                if (responseCode == HttpURLConnection.HTTP_OK) {
+                    InputStream input = connection.getInputStream();
+
+                    // Create temporary file
+                    File cacheDir = TiApplication.getInstance().getCacheDir();
+                    File imageFile = new File(cacheDir, "share_url_" + System.currentTimeMillis() + ".jpg");
+
+                    FileOutputStream output = new FileOutputStream(imageFile);
+
+                    byte[] buffer = new byte[4096];
+                    int bytesRead;
+                    long totalBytes = 0;
+
+                    while ((bytesRead = input.read(buffer)) != -1) {
+                        output.write(buffer, 0, bytesRead);
+                        totalBytes += bytesRead;
+                    }
+
+                    output.close();
+                    input.close();
+
+                    Log.d(TAG, "✓ Image downloaded successfully. Size: " + totalBytes + " bytes");
+                    Log.d(TAG, "Saved to: " + imageFile.getAbsolutePath());
+
+                    return imageFile;
+
+                } else {
+                    errorMessage = "HTTP error code: " + responseCode;
+                    Log.e(TAG, errorMessage);
+                    return null;
+                }
+
+            } catch (Exception e) {
+                errorMessage = "Download failed: " + e.getMessage();
+                Log.e(TAG, errorMessage, e);
+                return null;
+
+            } finally {
+                if (connection != null) {
+                    connection.disconnect();
+                }
+            }
+        }
+
+        @Override
+        protected void onPostExecute(File imageFile) {
+            if (imageFile != null && imageFile.exists()) {
+                Log.d(TAG, "Download completed, proceeding with share");
+                processShare(message, subject, imageFile);
+            } else {
+                Log.e(TAG, "Download failed, sharing text only");
+
+                // If callback exists, notify about download failure
+                if (callback != null) {
+                    fireCallback(false, errorMessage != null ? errorMessage : "Failed to download image");
+                } else {
+                    // Share text only if no callback
+                    processShare(message, subject, null);
+                }
+            }
+        }
+    }
 }

android/manifest

@@ -2,6 +2,7 @@
 <ti:module xmlns:ti="http://ti.appcelerator.org" xmlns:android="http://schemas.android.com/apk/res/android">
     <android>
         <manifest>
+            <uses-permission android:name="android.permission.INTERNET"/>
             <application>
                 <provider
                     android:name="androidx.core.content.FileProvider"