OneSignal/OneSignal-Website-SDK

[Question]: Migration Guide for v16

fresh-avocado opened this issue · 2 comments

fresh-avocado commented

How can we help?

A few years ago I configured One Signal in a website. I added the following script tag on all pages:

<script src="https://cdn.onesignal.com/sdks/OneSignalSDK.js" async />

and I also self-hosted OneSignalSDKWorker.js and OneSignalSDKUpdaterWorker.js. Both have the same file contents:

importScripts("https://cdn.onesignal.com/sdks/OneSignalSDK.js");

According to this migration guide I need to update the script tag to:

<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>

the contents of OneSignalSDKWorker.js to:

importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");

and rest of the updates: window.OneSignalDeferred = window.OneSignalDeferred || [] and OneSignalDeferred.push((OneSignal) => ...).

Thus, I have the following questions:

  1. What should happen to OneSignalSDKUpdaterWorker.js?
  2. After I make the necessary updates according to the migration guide, will the push notifications still work for my previous subscribers that used the previous SDK version?
  3. Are there any other things that I need to do in order to update the SDK version, but still make it work for old users?

Thank you in advance for your help! 😁

jkasten2 commented

@fresh-avocado Thanks for reaching out.

  1. What should happen to OneSignalSDKUpdaterWorker.js?

This file hasn't been used a while (since version 151510, Nov 22, 2021). However since you may have end-user who haven't visited your site since then to be extra safe I would recommend updating the contains of this file to importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js"); as well.

  1. After I make the necessary updates according to the migration guide, will the push notifications still work for my previous subscribers that used the previous SDK version?

yes, pushes will continue to be received and display for all existing subscribers. Even if they don't open your site again after updating.

  1. Are there any other things that I need to do in order to update the SDK version, but still make it work for old users?

No other changes are needed.

  • ❤️1
fresh-avocado commented

@jkasten2 thank you so much!