Using Shopify App Bridge to Build Faster, More Functional Apps

App Bridge

Update May 2021: App Bridge 2.0 now available

迁移到应用桥2.0我将确保你的应用s aligned with the future of Shopify. This new release of App Bridge also includes a more streamlined interface for actions and an improved architecture for tree-shaking.

As browsers applystricter restrictionson third-party cookie tracking, apps require an alternative way to handle authentication. App Bridge 2.0 paves the way for apps to migrate from third-party cookie authentication tosession tokens.

Learn more

Embedded apps are a crucial part of the Shopify ecosystem, allowing merchants to add functionality to their shops without leaving the familiar environment of the Shopify Admin. As a Shopify app developer, you've no doubt recognized the opportunity of building embedded apps to provide merchants with additional capabilities to help grow their businesses.

Over time, embedded apps have evolved from a tiny experiment to become more powerful than we could ever have imagined. Initially, Shopify Partners used tools called the Embedded App Software Development Kit (EASDK) and the Point of Sale Software Development Kit (POSSDK) to build embedded apps. But as our app ecosystem has grown, these tools haven't been able to keep up with developer needs.

That's why at Shopify Unite 2019,we introduceda unified tool for embedded app development on all Shopify platforms, calledShopify App Bridge.

Shopify App Bridge allows you to embed your app anywhere that merchants interact with their admin. A single front end written with Shopify App Bridge can power2022欧宝娱乐苹果下载 , desktop, and mobile experiences. Apps built with Shopify App Bridge are more performant and flexible, have more features, and can leverage hardware in a way that no other Shopify apps can. In this article, we look at the opportunities that developers can leverage using Shopify App Bridge.

Performance and flexibility

In a world before Shopify App Bridge, apps that wanted to be usable on both Shopify POS and the admin would need to use two separate client-side libraries: one for ShopifyPOS and one to embed in the web admin. Shopify App Bridge reduces this requirement to a single library, allowing for a more unified merchant experience and highly streamlined development flow.

Not only does Shopify App Bridge improve consistency and development efficiency, but it can also load apps up to four times faster than apps built with the EASDK or POSSDK.

App Bridge: Load Time
Shopify App Bridge load time vs EASDK load time on mobile devices.

You might also like:Building Shopify Apps: App Developers Share Their Experiences.

Actions and action sets

Actions are a new way for apps using Shopify App Bridge to interact with Shopify. By using actions, you gain control over many of Shopify's UI elements. The top bar, loading indicator, modals, resource pickers, and buttons are all available to make your app feel like a native Shopify experience. Actions can be easily dispatched to make things happen in context, like show a toast message or activate a contextual save bar.

The real power of actions is revealed once they're combined into action sets, persisted sets of actions that you can dispatch or subscribe to at any time. When you create an action set, its configuration is persisted and shared between Shopify and your app. Both sides are aware of the state of each action set: whether a modal is open, what lives inside the title bar, etc.

All action sets use the same interface to keep the API simple and consistent:create,set,subscribe, anddispatch.

  • Create: Used to initialize an action set, sometimes with options.
  • Set: Allows you to update the configuration of an action set when available. For example, updating the title in the title bar.
  • Subscribe: Notifies you of events in Shopify’s UI, like when a modal is closed.
  • Dispatch: Sends actions to Shopify, activating functionality.

Aside from a few exceptions, creating an action set simply stores the configuration inside the shared state, and doesn’t do much on its own. Action sets get actions ready for you to dispatch.

Action

Action types are statically defined actions that are available to action sets. These are the individual messages sent between your app and Shopify, to perform tasks and notify you of events. Using the toast message as an example, its action set isToast, and actions available to the toast action set areSHOWandCLEAR. Similarly, actions for theLoadingaction set areOB欧宝娱乐APPandSTOP. These are just two of the action sets available in Shopify App Bridge. As Shopify App Bridge continues to grow, we will be able to add even more action types to enable new capabilities.

App Bridge: Action type to display toast message
Using an action type to display a toast message.

Once you’ve created an action set, you candispatchthe actions it contains. You can alsosubscribeto actions dispatched by Shopify. For example, when a merchant closes a modal from the Shopify Admin, Shopify will dispatch aCLOSEaction that your app can subscribe to. Your app can provide a callback to be executed when the action is dispatched.

By combining a simple, consistent API—create,set,dispatch, andsubscribe—with statically defined actions, Shopify App Bridge offers you granular control with minimal cognitive overhead. This is also what makes Shopify App Bridge extensible. The use of actions also shifts away from methods tied to specific visual design. Instead, it provides you with composable building blocks grouped by their functionality.

Action sets also persist state transparently, allowing you to inspect the current state of your app using tools like Redux DevTools, and even replay past actions to help you debug.

App Bridge: Debugging with Redux
Debugging with Redux DevTools.

You might also like:The Shopify App CLI: A Tool to Help You Build Faster.

Hardware

Shopify App Bridge ships with the ability to access powerful device hardware features, including the camera and NFC reader, by using theScanneraction. Apps can useFeature Detectionto see what kind of device they're working on, and then request access to hardware on mobile devices if available. Once access is granted, feature detection dispatches an action to let the app know that the hardware is available and scanning can begin.

Change management

Technology moves fast today, and keeping up with constant changes is challenging. Shopify App Bridge strikes a balance between stability and delivering new features quickly by using strictSemVer library versioning, so you have full control over your adoption cycle.

Build apps for Shopify merchants

你是否想为Shopify应用构建应用程序Store, offer private app development services, or are looking for ways to grow your user base, the Shopify Partner Program will set you up for success. Join for free and access educational resources, developer preview environments, and recurring revenue share opportunities.

Sign up

A unified tool for embedded app development

Shopify应用桥帮助您开发嵌入式应用程序faster, creating new opportunities to build more integrated, functional products for merchants. Start leveraging these opportunities today.

To keep up to date on our journey to make Shopify App Bridge even better, be sure to subscribe to ourDeveloper Changelog.

How will Shopify App Bridge help you?Share your thoughts below.

Grow your business with the Shopify Partner Program

Learn more