ADN Open CIS
Сообщество программистов Autodesk в СНГ

04/07/2014

Autodesk Exchange Apps - Информация для разработчиков приложений под AutoCAD и вертикальных продуктов на базе AutoCAD

Это руководство предназначено для разработчиков, желающих опубликовать свои приложения и другие продукты в онлайн - магазине Autodesk® Exchange Apps в виде платных, бесплатных,  или пробных (trial) версий. В руководстве приведены практические рекомендации и требования к процессу публикации в Autodesk Exchange Apps.  Рекомендации призваны максимально облегчить загрузку пользователями приложений из Autodesk Exchange Apps.

Требования

После регистрации в качестве издателя вам будет представлен подробный перечень требований по публикации в онлайн-магазине приложений. Ниже представлена обобщенная информация.

При наличии расхождений приоритет имеет онлайновое Соглашение с издателем (Publisher Agreement).

Все типы материалов

Почти всю необходимую нам информацию вы предоставляете путем заполнения веб-формы при публикации своего продукта. Сюда относится информация для автоматической генерации стартовой HTML-страницы, которая включается в состав загрузки вашего приложения и доступна для просмотра online.  Прочие требования: 

  • Ваш продукт должен иметь непосредственное отношение и использоваться совместно с текущей версией AutoCAD или c текущей версией вертикального продукта на базе AutoCAD: AutoCAD® Architecture, AutoCAD® Electrical, AutoCAD® ecscad, AutoCAD® Mechanical, AutoCAD® MEP, AutoCAD® Civil 3D®. Продукт должен работать во всех операционных системах Windows, поддерживаемых текущей версией AutoCAD или текущей версией вертикальных продуктов на базе AutoCAD (включая 32- и 64- разрядные версии). Если вы указали, что ваше приложение совместимо с одним или несколькими вертикальными продуктами, вы должны проверить его работу с этими продуктами. Вы также можете указать совместимость с предыдущей версией AutoCAD (или вертикальных продуктов на базе AutoCAD).
  • Информация, которую при публикации приложения вы предоставляете в разделе «Документация», используется для генерации HTML-страницы стандартного формата. Она должна помочь пользователю быстро получить представление о вашем приложении. Вы можете использовать ссылки на дополнительную информацию (например, на файлы справки на вашем веб-сайте).
  • Настоятельно рекомендуем использовать стандартную программу установки (инсталляции) приложений Autodesk Exchange Apps, которую мы создаем для вас. По умолчанию у пользователя предполагаются права администратора
  • Windows 7 / Windows 8.  Наша программа установки  дополнительно требует у пользователя права на установку приложений.  Если вы не предполагаете использовать наш стандартный шаблон программы установки или не желаете, чтобы программа установки требовала от пользователя дополнительных прав, это должно быть четко отражено в описании на странице вашего продукта, на сайте магазина Autodesk Exchange Apps.
  • Продукт должен быть готов к работе сразу после установки. Он не должен требовать, чтобы пользователь вручную копировал и регистрировал файлы или вручную редактировал параметры AutoCAD (например, пути к файлам). Избежать этого вам поможет новый механизм автозагрузки, описанный в одном из следующих разделов.
  • Ваше приложение должно работать стабильно.  Оно не должно влиять на  работу AutoCAD способом, который мы считаем неприемлемым (например, блокировать стандартные функции, блокировать функции других надстроек, приводить к потере данных и т.д.).

Надстройки (Add-ins)

Дополнительные требования к надстройкам:

  • Ваша надстройка должна включать в себя частичный CUIX-файл для добавления элементов интерфейса на ленту AutoCAD. Подробнее это описано в одном из следующих разделов.

Библиотеки блоков

Дополнительные требования к библиотекам блоков:

  • Ваша библиотека блоков должна включать в себя частичный CUIX-файл для добавления элементов интерфейса на ленту AutoCAD. Интерфейс ленты должен предоставлять доступ к библиотеке блоков или позволять запускать файл справки, объясняющий процесс доступа к библиотеке. Подробнее это описано в одном из следующих разделов.
  • Ваши библиотеки блоков (в формате DWG) должны быть установлены в указанной ниже папке, чтобы ее можно было индексировать функцией AutoCAD Content Explorer (команда CONTENTEXPLORER).

Windows 7/8/Vista: %PUBLIC%\Documents\Autodesk\Downloaded Content (обычно C:\Users\Public\Documents\Autodesk\Downloaded Content)

Windows XP: %ALLUSERSPROFILE%\Documents\Autodesk\Downloaded Content (обычно C:\Documents and Settings\All Users\Documents\Autodesk\Downloaded Content)

Исполняемые приложения и другой контент

К продуктам, не интегрированным с AutoCAD, не предъявляется каких-либо дополнительных требований. К таким продуктам относятся электронные книги, обучающие видеоролики, специализированные калькуляторы и т.п.

Рекомендации

Использование системы Autoloader

Настоятельно рекомендуем использовать механизм автозагрузки надстроек. Информация по требуемому формату пакетов автозагрузчика приведена в справочной документации AutoCAD 2014. В документации найдите раздел «Install and Uninstall Plug-in Applications» или выполните поиск по слову «appautoloader». В видеоролике «DevTV –Autoloader Format Explained» представлены простые примеры установки надстроек .NET, ObjectARX, LISP и CUIX.

Вы также можете загрузить некоторые бесплатные надстройки, уже доступные в Autodesk Exchange, и изучить их формат, например надстройки из серии Autodesk Plug-in of the Month (OffsetInXref, DimensionPatrol или ClipboardManager).

Использование зарегистрированного кода разработчика

Если ваша надстройка использует вспомогательные пути для нахождения файлов (механизм автозагрузки широко использует вспомогательные пути), настоятельно рекомендуем добавить к именам ваших файлов префикс зарегистрированного кода разработчика (RDS), чтобы избежать потенциальных конфликтов имен с другими надстройками. Вы можете бесплатно зарезервировать обозначение RDS на странице www.autodesk.com/symbolreg. (Если вы не пользуетесь RDS, и ваши файлы конфликтуют с другой надстройкой, мы потребуем от вас переименовать файлы).

Это относится как к материалам (например, библиотекам блоков), так и к модулям надстроек. 

Загрузка по требованию

Если ваша надстройка ObjectARX® или .NET не требует обязательной загрузки при запуске AutoCAD, вам следует обеспечить загрузку надстройки только при необходимости. Обычно это называется загрузкой при вызове команды. Это призвано уменьшить влияние установленных надстроек на скорость запуска AutoCAD. Система автозагрузки позволяет легко задать параметры загрузки по требованию для различных компонентов надстройки.

Рекомендации по совместимости

Помимо использования зарегистрированного кода разработчика и параметров загрузки по требованию существует множество способов обеспечения нормальной работы надстройки параллельно с другими установленными надстройками. Эти способы описаны в руководстве ObjectARX Application Interoperability Guidelines, прилагаемом к ObjectARX SDK (можно загрузить на сайте from www.objectarx.com). Несмотря на то, что это руководство относится к ObjectARX SDK, многие из приведенных рекомендаций подходят для других типов надстроек. Ничего страшного, если вы разработали приложение, не читая это руководство — это лишь рекомендации, а не требования. Тем не менее, рекомендуем принять их во внимание при разработке новых приложений и обновлении существующих.

Использование ленты

Использование частичного CUIX-файла (partial CUIX) для добавления элементов на ленту является необходимым условием, но как вы это сделаете, зависит от особенностей вашей надстройки. Как минимум, каждая надстройка или библиотека блоков должна добавлять панель на вкладку «Надстройки(Plug-Ins)», с помощью которой вызываются основные команды надстройки или файл справки, объясняющий использование библиотеки блоков. В видеоролике «DevTV – Creating a Partial CUI» опубликованном вместе с данным руководством, демонстрируется создание частичного CUIX-файла для добавления панели на вкладку, уже заданную в основном CUIX.

Приложения с одной панелью обычно добавляют свою панель на вкладку «Надстройки(Plug-Ins)».

Для надстроек с несколькими панелями можно создать отдельную вкладку (в качестве имени вкладки обычно используется название надстройки).

Вы также можете добавлять в частичный CUIX-файл другие элементы интерфейса (например, меню и панели инструментов), но надстройка все равно должна иметь базовый интерфейс на Ленте.

Учебные видеоролики (на английском языке)

В приведенных ниже видеороликах содержится дополнительная информация по некоторым темам данного руководства:

  • DevTV – Autoloader Format Explained — видеоролик, в котором объясняется, как создать надстройку AutoCAD Plug-in в новом формате автозагрузки, который используется простой системой установки надстроек.
  • DevTV – Creating a Partial CUI — короткий видеоролик, демонстрирующий интегрирование пользовательского интерфейса надстройки AutoCAD в интерфейс ленты.

Дополнительная информация

Если у вас есть вопросы по процессу публикации приложений, вы можете задать их на русскоязычном форуме технической поддержки.

Коллектив ADN всегда готов помочь вам стать успешным издателем в онлайн-магазине Autodesk Exchange Apps. Мы постараемся сделать все возможное, чтобы оказать вам поддержку.  Пишите по адресу appsinfo@autodesk.com, если у вас возникнут вопросы после прочтения данного руководства и другой документации на www.autodesk.com/developapps.

Благодарим вас за интерес к онлайн-магазину приложений Autodesk Exchange Apps.

Обсуждение: http://adn-cis.org/forum/index.php?topic=845

Опубликовано 04.07.2014
Отредактировано 04.07.2014 в 14:56:50