Meteor 3.0 Migration Guide

Appearance

Upgrading packages ​

Client ​

For the packages that are client only or that are do not using Meteor packages that will become async or are already using async & await pattern.

The migration will look like this:

js
// in you package.js
Package.onUse((api) => {
  api.versionsFrom(['1.10', '2.3', '3.0']);
  //                               ^^^^^^^ for testing your package with meteor 3.0

  api.versionsFrom(['1.10', '2.3', '3.0']);
  //                              ^^^^^^^ for meteor 3.0
});

Then you can publish your package and test it with Meteor 3.0, by running meteor publish --release=3.0.4.

Changes for packages that do not use Meteor packages that had breaking change ​

Similar to what happens with client-only packages, if your package is not using Meteor packages that had breaking changes, you can update your package to be compatible with Meteor 3.0 by adding the following line to your package.js:

js
// in you package.js
Package.onUse((api) => {
  api.versionsFrom(['1.10', '2.3', '3.0']);
  //                               ^^^^^^^ for testing your package with meteor 3.0

  api.versionsFrom(['1.10', '2.3', '3.0']);
  //                     ^^^^^^^ for meteor 3.0
});

For example, we have mdg:seo where we just needed to add the line above to make it compatible with Meteor 3.0. You can see the commit.

Testing packages in Meteor 3.0 ​

It is known that some packages that are testing the beta changes are not being installed by correctly, when using a tag in their version, like this one: version: '2.0.0-beta300.6', to be sure that you are getting the correct version you can run meteor add <package>@<version-tag> to install the package with the correct version, instead of the meteor add <package>.

Server ​

If in your package you are using Meteor packages that will become async, you will need to migrate your package to use async & await pattern.

For concrete examples you can check a few examples of packages that have been in the works of migrating to Meteor 3.0:

You can follow a more in depth guide on how to migrate your package to be compatible with Meteor 3.0 here.

Maintaining compatibility with Meteor 2.x ​

You can use the Meteor.isFibersDisabled property to check if the current Meteor version is using Fibers or not. In all releases before Meteor 3.0 this property will be falsy(undefined). In Meteor 3.0 this property will be return true.

Which means that you can have a code like this, in your package:

js

if (Meteor.isFibersDisabled) {
  // Meteor 3.0
} else {
  // Meteor 2.x
}