|
|
<chapter id="tdevelop-scripting">
|
|
|
|
|
|
<chapterinfo>
|
|
|
<authorgroup>
|
|
|
<author><firstname>Ian</firstname><surname>Geiser</surname></author>
|
|
|
<!-- ROLES_OF_TRANSLATORS -->
|
|
|
</authorgroup>
|
|
|
</chapterinfo>
|
|
|
|
|
|
<title>Поддержка сценариев</title>
|
|
|
|
|
|
<sect1 id="running-scripts">
|
|
|
<title>Выполнение сценариев</title>
|
|
|
<para>Для получения доступа к сценариям воспользуйтесь меню <menuchoice><guimenu>Сервис</guimenu><guimenuitem>Сценарии</guimenuitem></menuchoice>. Если его нет, значит в KDevelop не установленных сценариев. </para>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="adding-scripts">
|
|
|
<title>Добавление сценариев</title>
|
|
|
<para>После добавления поддержки KScript в ваше главное приложение, добавление в него сценариев становится лёгкой задачей. Сценарии состоят из двух частей - файла .desktop, содержащего метаданные (текст пункта меню и интерпретатор), и собственно сценария. Этот подход был использован из соображений безопасности и простоты использования. </para>
|
|
|
<para>Этот пример демонстрирует основные части, которые нужны KScript. Первый элемент, "Name", определяет имя сценария, показываемое пользователи, а текст элемента "Comment" будет показан во всплывающей подсказке. Наиболее важным является "Type", он определяет интерпретатор, который будет использован для сценария. На текущий момент есть два возможных варианта - "ShellScript/bash" и "JavaScript/kjs". нашем примере выбран первый. Сценарию передаётся два аргумента . Первый - DCOP ID (дескриптор) главного приложения. </para>
|
|
|
|
|
|
<para>Приведенный сценарий устанавливает текст первого документа в вывод команды "ls -l"</para>
|
|
|
|
|
|
<para>Самое полезная программа для разработки таких сценариев - KDCOP.</para>
|
|
|
<figure id="screenshot-kdcop" float="1">
|
|
|
<title>Работа с DCOP-интерфейсами в &tdevelop; с помощью KDCOP</title>
|
|
|
<mediaobject>
|
|
|
<imageobject><imagedata fileref="kdcop_browsing.png"/></imageobject>
|
|
|
</mediaobject>
|
|
|
</figure>
|
|
|
|
|
|
<para>KDCOP позволяет просматривать и отлаживать интерфейсы приложений. На текущий момент KDCOP поддерживает KJSEmbed, Python и оболочки UNIX для работы с DCOP.</para>
|
|
|
|
|
|
<para>Когда сценарий написан, осталось его установить. Разработчики основного приложения должны позаботиться об этой процедуре, или хотя бы задокументировать пути, в которых будут искаться сценарии. В примере выше, сценарий Kate расположен в "$TDEDIRS/share/apps/kate/scripts".</para>
|
|
|
|
|
|
<figure id="screenshot-scripts" float="1">
|
|
|
<title>Сценарии &tdevelop; в файловой системе</title>
|
|
|
<mediaobject>
|
|
|
<imageobject><imagedata fileref="script_location.png"/></imageobject>
|
|
|
</mediaobject>
|
|
|
</figure>
|
|
|
|
|
|
<para>Файл .desktop должен быть в одной папке со сценарием. Разработчикам сценариев также рекомендуется хранить вспомогательные файлы, такие как файлы пользовательского интерфейса, файлы данных, в той же папке. Также заметим, что основное приложение блокируется на время выполнения сценария. но это будет изменено в KDE 4. </para>
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
</chapter>
|
