Permalink
Browse files

Merge branch 'xd-15-apis'

Documentation updates for XD 15
  • Loading branch information...
peterflynn committed Jan 29, 2019
2 parents 1c03034 + 8f4ef3a commit cff93fb22fa5765c32651b1da5c997a284109524
@@ -79,6 +79,7 @@
* [Distribution options](./distribution/options.md)
* [Publishing your plugin](./distribution/how-to-submit-to-plugin-manager.md)
* [Marketing your plugin](./distribution/marketing.md)
* [Deep-linking to your plugin listing](./distribution/how-to-create-deep-links.md)

## Join the Community

@@ -91,6 +92,7 @@
* [API references](./reference/how-to-read.md)
* [How to read this reference](./reference/how-to-read.md)
* [application](./reference/application.md)
* [assets](./reference/assets.md)
* [clipboard](./reference/clipboard.md)
* [cloud](./reference/cloud.md)
* [commands](./reference/commands.md)
@@ -1,13 +1,45 @@
# Change Log

## Public Release 14.0.42
## XD Release 15.0.12

### New API Features

* [Document & node metadata](./reference/scenegraph.md#SceneNode-pluginData): Store plugin-specific info on individual scenegraph nodes or in the document in general.
* [Viewport](./reference/viewport.md): Pan and zoom the view of the document, and get information about the current viewport bounds.
* [Text](./reference/scenegraph.md#Text): Get/set paragraph spacing; create/modify area text; more easily work with uniform-styled text via convenience getter/setter APIs for character attributes.
* [Published links](./reference/cloud.md): Get latest links for prototypes & design specs that have been shared from the current document.
* **[Assets panel colors & text styles](./reference/assets.md):** Get/add/remove any colors, gradients, and text styles saved in the Assets panel.
* **[Deep link to plugin listings](./distribution/how-to-create-deep-links.md):** Link from web sites, social media, etc. directly to your plugin listing in XD's UI so users can easily install the plugin.

### Breaking Changes

No breaking changes.

### Fixes and improvements

No other API changes.

### User-facing plugin features

* **Disable plugins:** Temporarily disable a plugin without uninstalling it or erasing its data. Choose _Plugins > Manage Plugins_, then click the "..." menu for a specific plugin and choose _Disable_.
A disabled plugin does not appear anywhere in the XD UI other than the Manage Plugins view, and none of its code is loaded or run.
* **Force stop:** If a plugin operation is blocking XD for more than one second with no UI shown, the user sees a spinner with the option to force-stop the plugin. _This does not stop the plugin's code
from running_, but it reverts any partially-completed changes to the document and revokes the plugin from being the foreground operation (unblocking the XD UI and blocking the plugin from making
document changes until it's invoked again by the user). If the plugin does eventually reawaken and try to continue running code from earlier, any attempts to modify the document will throw an error.

### Known Issues

* *New:* Plugins can modify the Assets panel contents while running in the background. Do not rely on this - in a future release, it will be blocked.

See the [Known Issues page](./known-issues.md) for a comprehensive list of existing known issues.


----

## XD Release 14.0.42

### New API Features

* **[Document & node metadata](./reference/scenegraph.md#SceneNode-pluginData):** Store plugin-specific info on individual scenegraph nodes or in the document in general.
* **[Viewport](./reference/viewport.md):** Pan and zoom the view of the document, and get information about the current viewport bounds.
* **[Text](./reference/scenegraph.md#Text):** Get/set paragraph spacing; create/modify area text; more easily work with uniform-styled text via convenience getter/setter APIs for character attributes.
* **[Published links](./reference/cloud.md):** Get latest links for prototypes & design specs that have been shared from the current document.

### Breaking Changes

@@ -21,20 +53,20 @@

### User-facing plugin features

* "Discover Plugins" listing improvements:
* **"Discover Plugins" listing improvements:**
* Sort by plugin name, in addition to the default of sorting by release date.
* Searching the plugin listing now searches the description field in addition to just the plugin title.
* Safe mode: To temporarily disable all plugins for troubleshooting purposes, launch XD while holding down Shift. Re-launching XD will re-enable all plugins.
* Uninstalling a plugin now clears its data/settings folder. Users are now prompted to confirm before uninstalling.
* **Safe mode:** To temporarily disable all plugins for troubleshooting purposes, launch XD while holding down Shift. Re-launching XD will re-enable all plugins.
* **Uninstalling** a plugin now clears its data/settings folder. Users are now prompted to confirm before uninstalling.

### Known Issues

See the [Known Issues page](./known-issues.md) for a comprehensive list.
No new known issues. See the [Known Issues page](./known-issues.md) for a comprehensive list of existing known issues.


----

## Public Release 13.0.12
## XD Release 13.0.12

### Fixes and improvements

@@ -5,7 +5,7 @@ This tutorial walks through the process of deep-linking to an XD plugin listing.
## Prerequisites

- Plugin listing deep-linking only works with users on Adobe XD 14+ (released in December 2018)
- Your plugin should have a plugin ID and be [listed on the Plugin Manager](/distribution/how-to-submit-to-plugin-manager.html)
- Your plugin should have a plugin ID and be [listed on the Plugin Manager](/distribution/how-to-submit-to-plugin-manager.md)

## URL & Parameters

@@ -4,4 +4,8 @@ No matter how you plan to distribute your XD plugin, your marketing must follow

For details, make sure to read the [Adobe Creative Cloud Developer Brand Guide](https://partners.adobe.com/content/dam/tep_assets/public/public_1/documents/Adobe-Creative-Cloud-Developer-Brand-Guide.pdf).

The brand tutorial includes best practices for brand assets in marketing, press releases, and social media, and is the best spot to get our most up to date assets. You’ll also find information for how to publicize and promote your plugin once it’s approved.
The brand tutorial includes best practices for brand assets in marketing, press releases, and social media, and is the best spot to get our most up to date assets. You’ll also find information for how to publicize and promote your plugin once it’s approved.

## Plugin deep links

You [can create a deep link](/distribution/how-to-create-deep-links.md) from web sites, social media, etc. directly to your plugin listing in XD's UI so users can easily install the plugin.
@@ -18,6 +18,10 @@
- Longer plugin command names may be truncated in the menu on Windows
- Workaround: keep your plugin command names short!

## Assets Panel

- Plugins can modify the Assets panel contents while running in the background. Do not rely on this - in a future release, it will be blocked. Only make modifications to the document (including Assets panel) while the plugin is running a user-invoked command.

## User Interface

- Checkboxes may fail to render correctly if in a scrollable container. To work around this issue, make sure the containing element has a background color. (`transparent` does not count; macOS only.)
Oops, something went wrong.

0 comments on commit cff93fb

Please sign in to comment.