Canvas Developer Guide

Getting Started
Using Canvas
Canvas SDK
Canvas Apps and Visualforce Pages
Lightning Component Code Examples
Canvas Apps in a Page Layout or a Mobile Card
Canvas Apps in the Publisher
Canvas Apps in the Chatter Feed
Canvas in the Salesforce Mobile App
Customizing Your App Lifecycle
Creating a CanvasLifecycleHandler
Associating Your CanvasLifecycleHandler with Your App
Filtering CanvasRequest Context Data
Controlling Canvas App Behavior
Presenting User Error Messages
Testing Your CanvasLifecycleHandler Implementation
Distributing Your CanvasLifecycleHandler Class
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Creating a CanvasLifecycleHandler

You can control your app lifecycle by providing an implementation of the Canvas.CanvasLifecycleHandler Apex interface that Salesforce can use.

The Apex Canvas.CanvasLifecycleHandler interface provides methods and callbacks for customizing app lifecycle behavior. Salesforce will use your implementation at runtime to let you run custom code. Use the following steps to create an implementation of the Canvas.CanvasLifecycleHandler interface.

  1. From Setup, enter Apex Classes in the Quick Find box, then select Apex Classes.
  2. Click New to create a Apex class.
  3. Create an Apex class that implements the Canvas.CanvasLifecycleHandler interface. You must implement the excludeContextTypes() and onRender() methods. Here’s a template example:
  4. After you’ve finished adding your code, save the Apex class.
  5. Optionally test your implementation by using the Canvas.Test class.
  6. To let Salesforce know which implementation to use for your app, associate your Apex class with your app.