In this tutorial we are going to learn how to build a barcode widget for an iOS device. In the previous part we focused on Android and Java, while in this part we're going to be using Swift. The process will be similar in many ways, except for the bridging method, which is going to slightly differ.

In part I of this series we will show how to create Android widget using Java.

1. Intro

In order to build the widget we will be creating a simple extension in xCode as well as a "bridge" that will allow our app to communicate with the widget. Let's begin!

2. Creating the widget

We can start by opening our project in xCode. Now, right click on the project folder and navigate to file > new > target.

This will open a new window with different extensions. Let's search for the "Widget Extension".

Next, we can select the product name of our widget.

I am going to name it "BarcodeWidget". Make sure to uncheck “Include Configuration Intent” and "Include live activity".

If we click the finish button, xCode is going to ask us if we want to create an active scheme. Select "activate".

Now, we can select our widget extension in the "targets" section and run it. Be sure to run it for iOS 14.0 and up, as the previous versions of iOS aren't compatible with the extension.

At this point, we should be able to see our widget on the home screen. For now, it is only displaying a simple date.

Let's take a look at the files created in our project. We can see that xCode created a new folder with the same name we set for the widget at the beginning.

To modify our widget we can open the "BarcodeWidget.swift" file. There are different functions and structures inside the file. Let's take a look at a few of them:

• "BarcodeWidget struct" deals with the main configuration of our widget. Here, we can set the display name as well as the widget's description. If we'd like our widget to be non-resizable and of a specific size (the default preview offers three options: small, medium and large) we can set it here by calling the supportedFamilies() function and passing it an argument, an array that contains our preferred widget sizes.

.supportedFamilies([.systemSmall, .systemMedium, .systemLarge])

• Next, there is the "BarcodeWidgetEntryView" struct where we can modify the widget's layout.

 struct BarcodeWidgetEntryView : View {
    var entry: Provider.Entry

    var body: some View {
        Text(entry.date, style: .time)
    }
}

• You may also find the "getTimeline() method". It provides an array of timeline entries for the current time and, optionally, any future times to update a widget.

 func getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
        var entries: [SimpleEntry] = []

        // Generate a timeline consisting of five entries an hour apart, starting from the current date.
        let currentDate = Date()
        for hourOffset in 0 ..< 5 {
            let entryDate = Calendar.current.date(byAdding: .hour, value: hourOffset, to: currentDate)!
            let entry = SimpleEntry(date: entryDate)
            entries.append(entry)
        }

        let timeline = Timeline(entries: entries, policy: .atEnd)
        completion(timeline)
    }

If you want a better understanding of the TimelineProvider and its functions, you can always check Apple's official documentation in here.

3. Bridging

To display data from our React Native app, we are going to need some additional settings. First, let's add the "App Group" capability to our project in order to let the widget communicate with the app. Find your main app target in the Xcode project settings, switch to the Signing & Capabilities tab and click on + Capability.

Then search for "App Groups" and double click on it.

Click the + button in the new "App Groups" capability created and choose your team. The final step is to add an app group identifier. After you finish, you should see your App Group id appear. If it comes up red - make sure to try the refresh button.

Now, we can do the same thing for our widget's target. We can open the widget's Signing & Capabilities tab and add a new "App Groups" capability. If we select the same team as before, we should be able to see the identifier we already created in our main project's target. Make sure the same id is selected on both targets.

We have to set one more thing before we start writing our code in React Native. This includes installing the "SharedGroupPreferences" package. From the terminal, run:

 npm i react-native-shared-group-preferences

Open your App file and import:

 import SharedGroupPreferences from 'react-native-shared-group-preferences'

Now, let's add this to our code:

 // Let's display a random 6 digit number
  const barcode = Math.floor(100000 + Math.random() * 900000).toString()

  const appGroupIdentifier = 'group.widget.barcode.jp'

  useEffect(() => {
  if (Platform.OS === 'ios'){
      const setWidgetData = async () => {await SharedGroupPreferences.setItem('widgetKey', {
        text: barcode !== undefined ? barcode : '',
      }, appGroupIdentifier)}
      setWidgetData()
        .catch((error) => {
          log.info(() => ['error setting widget data, err: ', error])
  },[barcode])

The "appGroupIdentifier" should be the same as the one we just set in our "App Groups".

Great! We are done with the React Native part. Now, let's go back to our widget's code.

To add new text to our widget, first we have to add the following code above our Provider:

 struct WidgetData: Decodable { var text: String }

Next, update the "SimpleEntry" struct:

 struct SimpleEntry: TimelineEntry { let date: Date let myString: String }

Variable "myString" is going to be our barcode string that we set in the React Native app. When we add this, an error is going to come up - telling you to update the number of arguments of certain methods. After fixing this error, our code should look something like this:

Now let's update our "getTimeline()" method with the following code:

 func getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
    var entries: [SimpleEntry] = []

    let userDefaults = UserDefaults.init(suiteName: "group.widget.barcode.jp")
    if userDefaults != nil {
      if let savedData = userDefaults!.value(forKey: "widgetKey") as? String {
        let decoder = JSONDecoder()
        let data = savedData.data(using: .utf8)
        if let parsedData = try? decoder.decode(WidgetData.self, from: data!) {
          let currentDate = Date()
          let entryDate = Calendar.current.date(byAdding: .second, value: 3, to: currentDate)!

          let entry = SimpleEntry(date: entryDate, myString: parsedData.text)
          entries.append(entry)

          let timeline = Timeline(entries: entries, policy: .atEnd)
          completion(timeline)
        } else {
          print("Could not parse data")
        }
      } else {
        let currentDate = Date()

        for hourOffset in 0 ..< 2 {
          let entryDate = Calendar.current.date(byAdding: .second, value: hourOffset, to: currentDate)!
          let entry = SimpleEntry(date: entryDate, myString: "No data")
          entries.append(entry)
        }

        let timeline = Timeline(entries: entries, policy: .atEnd)
        completion(timeline)
      }
    }
  }

Replace the "suiteName" value with your own App Group ID in the following line:

 UserDefaults.init(suiteName: "group.widget.barcode.jp")

The last thing to set before running our widget again is the "BarcodeWidgetEntryView" struct. In order to display the barcode text from the React Native app - let's add this:

 struct BarcodeWidgetEntryView : View { var entry: Provider.Entry

var body: some View {
   Text(entry.myString).font(.system(size: 12)).tracking(2)
}
}

Remember to run pod install in your iOS folder. Now, let's start the app.

If everything works well, the barcode number we previously set in our app will be displayed on the widget.

4. Generating the barcode image from a string value

The only thing that's left to do includes generating a barcode image from our barcode number as well as displaying it.

To do this, we are going to add a few functions to our "BarcodeWidget.swift" file.

The first function we are going to add is "generateBarcode()":

 func generateBarcode(from string: String) -> UIImage? {

  let data = string.data(using: String.Encoding.ascii)

  if let filter = CIFilter(name: "CICode128BarcodeGenerator") {
    filter.setDefaults()
    //Margin
    filter.setValue(1.00, forKey: "inputQuietSpace")
    filter.setValue(data, forKey: "inputMessage")
    //Scaling
    let transform = CGAffineTransform(scaleX: 3, y: 3)

    if let output = filter.outputImage?.transformed(by: transform) {
        let context:CIContext = CIContext.init(options: nil)
        let cgImage:CGImage = context.createCGImage(output, from: output.extent)!
        let rawImage:UIImage = UIImage.init(cgImage: cgImage)

        //Refinement code to allow conversion to NSData or share UIImage. Code here:
        //http://stackoverflow.com/questions/2240395/uiimage-created-from-cgimageref-fails-with-uiimagepngrepresentation
        let cgimage: CGImage = (rawImage.cgImage)!
        let cropZone = CGRect(x: 0, y: 0, width: Int(rawImage.size.width), height: Int(rawImage.size.height))
        let cWidth: size_t  = size_t(cropZone.size.width)
        let cHeight: size_t  = size_t(cropZone.size.height)
        let bitsPerComponent: size_t = cgimage.bitsPerComponent
        //THE OPERATIONS ORDER COULD BE FLIPPED, ALTHOUGH, IT DOESN'T AFFECT THE RESULT
        let bytesPerRow = (cgimage.bytesPerRow) / (cgimage.width  * cWidth)

        let context2: CGContext = CGContext(data: nil, width: cWidth, height: cHeight, bitsPerComponent: bitsPerComponent, bytesPerRow: bytesPerRow, space: CGColorSpaceCreateDeviceRGB(), bitmapInfo: cgimage.bitmapInfo.rawValue)!

        context2.draw(cgimage, in: cropZone)

        let result: CGImage  = context2.makeImage()!
        let finalImage = UIImage(cgImage: result)

        return finalImage

    }
}

When we run the application again, the widget should be displaying both the text and the image, as shown below:

5. Updating the widget content

Now, let's focus on keeping our widget up to date. First let's change our update policy to "never" since we are going to instruct the app on when to update its content.

 let timeline = Timeline(entries: entries, policy: .never)

Let's create a "reloadWidget()" function in the Swift code that we are later going to call in our React Native app. This can be done by adding two files to our project. Select "new file" and choose "Swift File" in the next window.

Next, let's name the file "WidgetModule" and select your app as the target of this file.

Update the "WidgetModule.swift" file as shown below:

 import Foundation
import AVFoundation
import WidgetKit

@objc(WidgetModule)
class WidgetModule: NSObject {

  @objc public func reloadWidget(_ kind: String) -> Void {
     if #available(iOS 14.0, *) {
       #if arch(arm64) || arch(i386) || arch(x86_64)
       WidgetCenter.shared.reloadAllTimelines()
       #endif
     }
   }

  @objc
  static func requiresMainQueueSetup() -> Bool {
    return true
  }

}

Our "reloadWidget" is using WidgetCenter.shared.reloadAllTimelines() method to reload the widget's timeline. For more details about reloading the widget check this link.

Now we need to add the other file. Choose "Objective-C":

Let's name it the same as the file before "WidgetModule" and select the same file target as of the previously created file.

Update the file like this:

 #import <Foundation/Foundation.h>

#import "React/RCTBridgeModule.h"
@interface
RCT_EXTERN_MODULE(WidgetModule, NSObject)
RCT_EXTERN_METHOD(reloadWidget: (NSString *)kind)

@end

This file will be used to export our newly created module that we are going to use later in the React Native app.

The last file that we are going to add is a Bridging Header. Again, add a new file and choose "Header".

Paste the following code:

 //
//  Use this file to import your target's public headers that you would like to expose to Swift.
//

#import "React/RCTBridgeModule.h"

Finally let's call our "updateWidget" function from the React Native code;

First, import NativeModules in the App file:

 import { NativeModules } from 'react-native'

export const App = () => { const { WidgetModule } = NativeModules

... }

Then, let's update our "useEffect" hook by adding .then(() => WidgetModule.reloadWidget(appGroupIdentifier)) to setWidgetData() method.

The final result should look like this:

 if (Platform.OS === 'ios'){
      const setWidgetData = async () => {await SharedGroupPreferences.setItem('widgetKey', {
        text: barcode !== undefined ? barcode : '',
      }, appGroupIdentifier)}
      setWidgetData()
        .then(() => WidgetModule.reloadWidget(appGroupIdentifier))
        .catch((error) => {
          log.info(() => ['error setting widget data, err: ', error])
        })

7. The end

Alright, it looks like we are done!

Don't forget to run npm install && cd iOS && pod install before running your project again. The widget layout should now be updating every time we call the "updateWidget" function.

Feel free to play around with different widget options and try to add some style to it.

Good luck with your project, I hope this tutorial helped you!

A widget, or a gadget, is a tiny application or extension which enables additional features and improves the user's general experience. They can help us facilitate access to the most used functions of a device and offer us visual information without the need to run anything else.

Unfortunately, widget development is not feasible using React Native alone. An alternative is to create a native widget and a "bridge" that will allow communication between the widget and the React Native application.

In this part we are focusing on building barcode widget for Android platform, using Java.

In part II of this series we will show how to create iOS widget using Swift.

1. Intro

First, we are going to create a simple widget that will only display the barcode number (string value) pulled from our React Native app that we're making the widget for.

Later, we will generate a barcode image from our barcode string and display it on our widget layout.

2. Creating the widget

We can start by opening our React Native project in Android Studio. Be sure to select the android folder when opening your project. Navigate to res > New > Widget > App Widget. This will let us create the widget extension for Android.

Here we are able to configure some default options for our widget. This includes: the class name, minimum width and height (in cells), resizability (horizontally, vertically, none), the source language (Java/Kotlin) etc.

This time I am going to create a 2x1 widget that isn't resizable.

If we click "finish", Android studio is going to display a preview of all the files that are going to be created. Here, we can also note that setting our class name to BarcodeWidget will create a java file with the same name.

3. Bridging

In order to let our app communicate with the widget, control what's displayed and share data, we have to make the previously mentioned "bridge". Bridging is simply building your own custom modules that aren't provided by the default Components given by React.

Now you may find the folder where your MainActivity.java file is located. In this folder we are going to add two files: SharedStorage.java and SharedStoragePackager.java.

In the first file we are going to add the code written below. This code includes a set() method that we're going to use later to set some data in the shared storage.

So, let's add the following code to out SharedStorage.java file:

 // PUT YOUR PACKAGE NAME HERE, IT'S THE SAME AS IN MainApplication.java
package com.yourpackage;

import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;

import android.app.Activity;
import android.appwidget.AppWidgetManager;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.SharedPreferences;
import android.util.Log;

public class SharedStorage extends ReactContextBaseJavaModule {
    ReactApplicationContext context;

    public SharedStorage(ReactApplicationContext reactContext) {
        super(reactContext);
        context = reactContext;
    }

    @Override
    public String getName() {
        return "SharedStorage";
    }

    @ReactMethod
    public void set(String message) {
        SharedPreferences.Editor editor = context.getSharedPreferences("DATA", Context.MODE_PRIVATE).edit();
        editor.putString("appData", message);
        editor.commit();

        // CHANGE TO THE NAME OF YOUR WIDGET
        Intent intent = new Intent(getCurrentActivity().getApplicationContext(), Widget.class);
        intent.setAction(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
        // CHANGE TO THE NAME OF YOUR WIDGET
        int[] ids = AppWidgetManager.getInstance(getCurrentActivity().getApplicationContext())
                .getAppWidgetIds(new ComponentName(getCurrentActivity().getApplicationContext(), Widget.class));
        intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, ids);
        getCurrentActivity().getApplicationContext().sendBroadcast(intent);

    }
}

Be sure to replace com.yourpackage with your own package name, and Widget.class with the class you created.

As you can see, in the method set() we can now use SharedPreferences object. This object points to a file containing key-value pairs and provides simple methods to read and write them.

The second file is the one that will allow us to use SharedStorage as a native module. So update your SharedStoragePackager.java file like this:

 // PUT YOUR PACKAGE NAME HERE, IT'S THE SAME AS IN MainApplication.java
package com.yourpackage;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.JavaScriptModule;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class SharedStoragePackager implements ReactPackage {

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
        return Collections.emptyList();
    }

    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
        List<NativeModule> modules = new ArrayList<>();

        modules.add(new SharedStorage(reactContext));

        return modules;
    }

}

Again make sure your package name is written correctly at the beginning of the code.

Now that we added the files, we have to import our SharedStoragePackager in the MainApplication.java file. Add the following line to your getPackages() method:

 packages.add(new SharedStoragePackager());

It should look something like this:

4. Layout

To start editing the layout, let's check which other files Android Studio created in our project.

Navigate to res > layout. Here, we can update the interface of our widget. We can add different view elements and styles to the XML file in order to change the widget's appearance.

We can style our Android widget in two ways:

1. Drag and drop options directly from Android Studio
2. Adding layout elements to our XML file manually

Drag and drop method

Let's take a look at the first method. By accessing our XML file (res > layout > XML code) from the Android Studio we are able to browse through a Palette menu and simply drag and drop any element we need.

Underneath the Palette menu you may also find a Component Tree. This window shows us exactly how our elements are being nested in the widget layout.

Manual method

Another way to customize the look of our widget includes opening the XML file through the editor and put in our own elements manually.

Take a note of the android:id attribute since you are going to use it later to access these View components from Java code.

For additional information on these attributes and descriptions, and how to configure your widget, click here.

In the values folder you can set up additional information such as strings, styles, colours, themes...

If, for any reason, you want to edit the configuration properties (eg. minimum height/width) that you set at the very beginning, you can do so by opening barcode_widget_info.xml located in the res > xml folder.

Here you can also set the preview image that will be displayed in the widget gallery. This is done by editing the android:previewImage attribute and importing a new PNG image in drawable-nodpi folder.

Take note of the text that follows after @layout/. In our example this is "barcode_widget". (@layout/barcode_widget) This information serves as a unique identification and will be crucial later on when we edit data from the java code.

Notice that here we are using targetCellWidth and targetCellHeight displayed in cells for Android 12 and more. For lower versions of Android, make sure that you have set minWidth and minHeight since the previous two attributes would be ignored. (Here you can find more information about these attributes.)

5. Setting the data from the React Native app

If we run our code now - we will be able to see our widget in the widget library, but still no data from our app will be shown.

To display our own data, we have to open our App.js file and try setting the barcode string value in our newly created SharedStorage module.

First, import the native module.

 import { NativeModules } from 'react-native';
const SharedStorage = NativeModules.SharedStorage;

Then add this anywhere to your code:

 let barcode = "1234567"
useEffect(() => {
  if (Platform.OS === 'android') {
    SharedStorage.set(JSON.stringify({barcode: barcode}))
  }
}, [barcode])

As shown above, we are using the set method from SharedStorage class to set the barcode value to a key barcode.

This is pretty much it for the React Native part, now let's go to our BarcodeWidget.java file that was created in the same folder as MainApplication.java.

6. Updating the widget content

Check out the updateAppWidget() method since this is where we are going to do all the logics. This method is responsible for updating the widget content.

We also need to modify our BarcodeWidget class by adding the SharedPreferences object. This object helps us get the data we set earlier in our App.js file.

 import org.json.JSONException;
import org.json.JSONObject;
import android.content.SharedPreferences;
...

static void updateAppWidget(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {

 try {
  SharedPreferences sharedPref = context.getSharedPreferences("DATA", Context.MODE_PRIVATE);
  String appString = sharedPref.getString("appData", "{\"text\":'no data'}");
  JSONObject appData = new JSONObject(appString);
  // Construct the RemoteViews object
  RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.barcode_widget);
  views.setTextViewText(R.id.appwidget_text, appData.getString("barcode"));
  // Instruct the widget manager to update the widget
  appWidgetManager.updateAppWidget(appWidgetId, views);
 } catch (JSONException e) {
  e.printStackTrace();
 }
}

To access specific value from the storage we will use:

 appData.getString("barcode")

The argument of the getString method is the key that we set in React Native app with SharedStorage.set() method.

Also, don't forget to change "barcode_widget" in R.layout.barcode_widget to your own widget id (located in barcode_widget_info.xml file that we talked about earlier).

If we run the app again the text displayed on your widget will finally be the same as the one we set in the React Native app.

Let's quickly go back to our updateAppWidget() method. To access any element in the widget layout XML file we are going to use RemoteView.

In our example, we used the setTextViewText() method to set content description to our TextView component.

The first argument is the id of the view component and the second is the value.

For more details about this class and other methods you can use, check this link.

7. Generating the barcode image from a string value

Finally, we are going to modify our BarcodeWidget.java class so it can generate a barcode image from the barcode string we sent before.

Add following functions and imports to the BarcodeWidget class:

 import com.google.zxing.BarcodeFormat;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.WriterException;
import com.google.zxing.common.BitMatrix;
import android.graphics.Bitmap;

public class BarcodeWidget extends AppWidgetProvider {

  private static int size_width = 720;
  private static int size_height = 244;
  public static Bitmap createBarcode(String barcodeText) {
    Bitmap bitmap = null;
    try {
      bitmap = CreateImage(barcodeText);
    } catch (WriterException we) {
      we.printStackTrace();
    }

    return bitmap;
  }

  public static Bitmap CreateImage(String message) throws WriterException {
      BitMatrix bitMatrix = new MultiFormatWriter().encode(message, BarcodeFormat.CODE_128, size_width, size_height);

      int width = bitMatrix.getWidth();
      int height = bitMatrix.getHeight();
      int [] pixels = new int [width * height];
      for (int i = 0 ; i < height ; i++) {
        for (int j = 0 ; j < width ; j++) {
          if (bitMatrix.get(j, i)) {
            pixels[i * width + j] = 0xff000000;
          } else {
            pixels[i * width + j] = 0xffffffff;
          }
        }
      }
      Bitmap bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
      bitmap.setPixels(pixels, 0, width, 0, 0, width, height);
      return bitmap;
  }
...
}

As shown above, we are using the zxing library here, so we should update the build.gradle file with the following code:

 implementation 'com.google.zxing:core:3.5.1'

The CreateImage() method is going to generate a bitmap from the string that we sent as an argument. It works by setting the value of a pixel to either black or white.

There are also many different format options when creating a bit matrix. We are going to use CODE128. For other options check this link.

Now, let's call this function in the updateAppWidget() method:

 static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
                                int appWidgetId) {
  try {
    SharedPreferences sharedPref = context.getSharedPreferences("DATA", Context.MODE_PRIVATE);
    String appString = sharedPref.getString("appData", "{\"text\":'no data'}");
    JSONObject appData = new JSONObject(appString);

    // Construct the RemoteViews object
    RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.barcode_widget);
    views.setTextViewText(R.id.appwidget_text, appData.getString("barcode"));
    Bitmap myBitmap = createBarcode(appData.getString("barcode"));

    // Instruct the widget manager to update the widget
    appWidgetManager.updateAppWidget(appWidgetId, views);
  } catch (JSONException e) {
    e.printStackTrace();
  }
}

To display our image we need to add the ImageView component to our barcode_widget.xml file located in layout folder:

 <RelativeLayout
  android:layout_width="wrap_content"
  android:layout_height="wrap_content">
  <ImageView
    android:id="@+id/imageView_id"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />
</RelativeLayout>

Again, pay attention to the id attribute (imageView_id) that we are going to use to get the current ImageView component:

 static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
                                int appWidgetId) {
  try {
    SharedPreferences sharedPref = context.getSharedPreferences("DATA", Context.MODE_PRIVATE);
    String appString = sharedPref.getString("appData", "{\"text\":'no data'}");
    JSONObject appData = new JSONObject(appString);

    // Construct the RemoteViews object
    RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.barcode_widget);
    views.setTextViewText(R.id.appwidget_text, appData.getString("barcode"));

    //setting up Bitmap image we created from barcode string to ImageView
    Bitmap myBitmap = createBarcode(appData.getString("barcode"));
    views.setImageViewBitmap(R.id.imageView_id, myBitmap);

    // Instruct the widget manager to update the widget
    appWidgetManager.updateAppWidget(appWidgetId, views);
  } catch (JSONException e) {
    e.printStackTrace();
  }
}

8. The end

Now, the only thing that's left is to run the application again.

Your widget should now display both the text and the generated image. If this is the case - then we are done!

You can now play around with the design and customize your widget further by adding more attributes and styles to your barcode layout xml file.

Hope this tutorial helped you and good luck with your project!