Add version 2.4.2

Author: schiewe

CHANGELOG.md

@@ -1,3 +1,9 @@
+## [2.4.2]
+
+### Fixed
+
+* [Android] Fixed serialization export file URL to include the schema.
+
 ## [2.4.1]
 
 ### Fixed

README.md

@@ -17,6 +17,8 @@
 
 # React Native module for PhotoEditor SDK
 
+Check out our [video tutorial](https://blog.photoeditorsdk.com/a-photo-and-video-editor-for-your-react-native-apps) for a step-by-step integration guide which also details advanced SDK features, such as serializing and reusing previously applied editing operations.
+
 ## Getting started
 
 Install the React Native module in your project as follows:
@@ -81,11 +83,11 @@ For older React Native versions autolinking is not available and PhotoEditor SDK
        }
        dependencies {
            classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.3.61"
-           classpath 'ly.img.android.sdk:plugin:7.1.13'
+           classpath 'ly.img.android.sdk:plugin:7.2.5'
        }
    }
    ```
-   In order to update PhotoEditor SDK for Android replace the version string `7.1.13` with a [newer release](https://github.com/imgly/pesdk-android-demo/releases).
+   In order to update PhotoEditor SDK for Android replace the version string `7.2.5` with a [newer release](https://github.com/imgly/pesdk-android-demo/releases).
 
 3. Configure PhotoEditor SDK for Android by opening the `android/app/build.gradle` file  (**not** `android/build.gradle`) and adding the following lines under `apply plugin: "com.android.application"`:
    ```groovy

android/src/main/java/ly/img/react_native/pesdk/RNPhotoEditorSDKModule.kt

@@ -80,7 +80,7 @@ class RNPhotoEditorSDKModule(val reactContext: ReactApplicationContext) : ReactC
                                                 val file = serializationConfig.filename?.let { Export.convertPathToFile(it) }
                                                   ?: File.createTempFile("serialization", ".json")
                                                 PESDKFileWriter(settingsList).writeJson(file)
-                                                file.absolutePath
+                                                Uri.fromFile(file).toString()
                                             }
                                             SerializationExportType.OBJECT -> {
                                                 ReactJSON.convertJsonToMap(

index.d.ts

@@ -1,6 +1,18 @@
 import { Component } from 'react';
 import { Configuration } from './configuration';
 
+/**
+ * The result of an export.
+ */
+interface PhotoEditorResult {
+  /** The edited image. */
+  image: string;
+  /** An indicator whether the input image was modified at all. */
+  hasChanges: boolean;
+  /** All modifications applied to the input image if `export.serialization.enabled` of the `Configuration` was set to `true`. */
+  serialization?: string | object;
+}
+
 declare class PESDK {
   /**
    * Modally present a photo editor.
@@ -17,17 +29,14 @@ declare class PESDK {
    * restores a previous state of the editor by re-applying all modifications to the loaded
    * image.
    *
-   * @return {Promise<{image: string, hasChanges: boolean, serialization: object}>} Returns the
-   * edited `image`, an indicator (`hasChanges`) whether the input image was modified at all, and
-   * all modifications (`serialization`) applied to the input image if `export.serialization.enabled`
-   * of the `configuration` was set. If the editor is dismissed without exporting the edited image
-   * `null` is returned instead.
+   * @return {Promise<PhotoEditorResult>} Returns a `PhotoEditorResult` or `null` if the editor
+   * is dismissed without exporting the edited image.
    */
   static openEditor(
     image: string | {uri: string} | number,
-    configuration: Configuration,
-    serialization: object
-  ): Promise<{image: string, hasChanges: boolean, serialization: object}>
+    configuration?: Configuration,
+    serialization?: object
+  ): Promise<PhotoEditorResult>
 
   /**
    * Unlock PhotoEditor SDK with a license.
@@ -88,15 +97,11 @@ interface PhotoEditorModalProps {
 
   /**
    * This prop determines the callback function that will be called when the user exported an image.
-   *
-   * The object passed to this callback includes the edited `image`, an indicator (`hasChanges`) whether
-   * the input image was modified at all, and all modifications (`serialization`) applied to the input image
-   * if `export.serialization.enabled` of the `configuration` prop was set.
    */
-  onExport: ({image: string, hasChanges: boolean, serialization: object}) => void;
+  onExport: (args: PhotoEditorResult) => void;
 
   /**
-   * This prop determines the callback function that will be called when the user dissmisses the editor without
+   * This prop determines the callback function that will be called when the user dismisses the editor without
    * exporting an image.
    */
   onCancel?: () => void;

index.js

@@ -103,11 +103,8 @@ class PESDK {
    * restores a previous state of the editor by re-applying all modifications to the loaded
    * image.
    *
-   * @return {Promise<{image: string, hasChanges: boolean, serialization: object}>} Returns the
-   * edited `image`, an indicator (`hasChanges`) whether the input image was modified at all, and
-   * all modifications (`serialization`) applied to the input image if `export.serialization.enabled`
-   * of the `configuration` was set. If the editor is dismissed without exporting the edited image
-   * `null` is returned instead.
+   * @return {Promise<PhotoEditorResult>} Returns a `PhotoEditorResult` or `null` if the editor
+   * is dismissed without exporting the edited image.
    */
   static openEditor(image = null, configuration = null, serialization = null) {
     resolveStaticAssets(configuration)

ios/RNImglyKit.m

@@ -36,7 +36,7 @@ - (void)present:(nonnull IMGLYMediaEditViewControllerBlock)createMediaEditViewCo
 #if RN_IMGLY_DEBUG
   {
     // For release debugging
-    NSURL *debugURL = [RCTConvert IMGLYExportFileURL:@"imgly-debug" withExpectedUTI:kUTTypeJSON];
+    NSURL *debugURL = [RCTConvert RN_IMGLY_ExportFileURL:@"imgly-debug" withExpectedUTI:kUTTypeJSON];
     if (debugURL) {
       NSError *error = nil;
       NSJSONWritingOptions debugOptions = NSJSONWritingPrettyPrinted;
@@ -106,7 +106,10 @@ - (void)present:(nonnull IMGLYMediaEditViewControllerBlock)createMediaEditViewCo
 
     // Update configuration
     NSMutableDictionary *updatedDictionary = [NSMutableDictionary dictionaryWithDictionary:dictionary];
-    [updatedDictionary setValue:exportFile.absoluteString forKeyPath:@"export.filename"];
+    NSMutableDictionary *exportDictionary = [NSMutableDictionary dictionaryWithDictionary:[NSDictionary RN_IMGLY_dictionary:updatedDictionary valueForKeyPath:@"export" default:@{}]];
+    [exportDictionary setValue:exportFile.absoluteString forKeyPath:@"filename"];
+    [updatedDictionary setValue:exportDictionary forKeyPath:@"export"];
+
     configuration = [[PESDKConfiguration alloc] initWithBuilder:^(PESDKConfigurationBuilder * _Nonnull builder) {
       builder.assetCatalog = assetCatalog;
       [builder configureFromDictionary:updatedDictionary error:&error];

package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-photoeditorsdk",
   "title": "React Native module for PhotoEditor SDK",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "A React Native module for PhotoEditor SDK. Integrate the photo editor into your own HTML5, iOS or Android app - in minutes!",
   "main": "index.js",
   "typings": "index.d.ts",