exponenta event banner

Создание настраиваемых задач

Пользовательские задачи - это функции MATLAB ®, позволяющие выполнять ряд операций над одним или несколькими файлами. Можно создать пользовательскую функцию задачи, а затем запустить пользовательскую задачу для выбранного набора файлов в проекте. Например, можно создать пользовательскую задачу для проверки всех файлов кода на наличие ошибок или для выполнения всех тестов в проекте.

Создание пользовательской функции задачи

Чтобы создать пользовательскую функцию задачи, выполните следующие действия.

  1. На вкладке Проект щелкните Настраиваемые задачи и выберите Управление настраиваемыми задачами. Откроется диалоговое окно Управление пользовательскими задачами (Manage Custom Tasks).

  2. Щелкните Добавить (Add), а затем выберите Добавить с помощью новой функции (Add Using New Function). Если необходимо добавить существующий сценарий в качестве пользовательской задачи, выберите «Добавить с помощью существующей функции».

  3. Укажите имя файла для сценария и сохраните новый файл по пути MATLAB. Редактор MATLAB открывает новый файл, содержащий пример пользовательской функции задачи.

  4. Отредактируйте функцию для выполнения требуемого действия с каждым файлом. Используйте инструкции в верхней части файла, чтобы создать пользовательскую задачу с правильной подписью функции. Пользовательские задачи должны принимать полный путь к файлу в качестве единственного входного аргумента и возвращать один выходной аргумент.

    Например, эта пользовательская функция задачи извлекает информацию анализатора кода для каждого файла с помощью checkcode функция.

    [~,~,ext] = fileparts(file);
    switch ext
        case {'.m', '.mlx', '.mlapp'}
            result = checkcode(file, '-string');
        otherwise
            result = [];
    end

  5. Сохраните файл.

Редактор MATLAB можно использовать для установки точек останова и отладки пользовательской функции задачи, как и для любой другой функции MATLAB.

Запуск настраиваемой задачи

Чтобы запустить пользовательскую задачу для выбранного набора файлов в проекте, выполните следующие действия.

  1. На вкладке Проект щелкните Настраиваемые задачи и выберите Выполнить настраиваемую задачу.

  2. В столбце Включить (Include) таблицы выберите файлы проекта, в которых требуется выполнить пользовательскую задачу.

    Чтобы одновременно включить или исключить несколько файлов из таблицы, нажмите клавишу Shift или Ctrl, выберите файлы, а затем щелкните правой кнопкой мыши и выберите Включить или Исключить. Если пользовательская функция задачи может идентифицировать файлы для работы, включите все файлы.

  3. В поле Пользовательская задача выберите из доступных пользовательских функций задачи. Можно также ввести имя задачи непосредственно в поле или нажать кнопку Обзор.

  4. Щелкните Выполнить задачу, чтобы запустить задачу. Результаты отображаются в окне Отчет о настраиваемых задачах (Custom Task Report).

  5. Проверьте столбец Результаты в таблице, чтобы убедиться, что пользовательская задача запущена правильно для всех файлов. Чтобы просмотреть подробную информацию о результатах для файла, выберите файл в таблице. На панели результатов в нижней части отчета о настраиваемых задачах отображаются подробные сведения.

Сохранить отчет о настраиваемых задачах

Сохранение отчета о настраиваемых задачах полезно, если требуется сохранить запись результатов настраиваемых задач или предоставить доступ к результатам другим пользователям.

Чтобы сохранить отчет о настраиваемых задачах, нажмите кнопку «Опубликовать отчет» в нижней части отчета о настраиваемых задачах. Отчет можно сохранить в формате HTML или Microsoft ® Word. При наличии Generator™ отчета MATLAB можно также сохранить отчет в виде PDF-файла.

Чтобы просмотреть файл отчета и добавить его в проект, перейдите в режим просмотра «Все файлы».

Связанные темы