exponenta event banner

Устранение неполадок при анализе в пространстве из MATLAB

При выполнении анализа Polyspace ® в коде C/C + +, если не удается скомпилировать один или несколько файлов, анализ продолжается с оставшимися файлами. Можно остановить анализ ошибок компиляции.

proj = polyspace.Project;
proj.Configuration.EnvironmentSettings.StopWithCompileError = true;

Однако удобнее позволить анализу завершить и зафиксировать все ошибки компиляции.

Ошибки компиляции отображаются в журнале анализа, который отображается в окне команд MATLAB ®. Журнал анализа также содержит используемые опции и различные этапы анализа. Строки, указывающие на ошибки, начинаются с Error: строка. Найдите эти строки и извлеките их в файл журнала для упрощения сканирования. Выведите предупреждение, указывающее на ошибки компиляции.

Предпосылки

Перед запуском Polyspace из MATLAB необходимо связать установки Polyspace и MATLAB. См. раздел Интеграция полиспейса с MATLAB и Simulink.

Фиксация ошибок анализа полиспейса в журнале ошибок

Функция runPolyspace определяется позже захватывает выходные данные из окна команд с помощью evalc функция и сохраняет строки, начиная с Error: в файле error.log. Вы можете позвонить runPolyspace с путями к источнику и включать папки.

Например, можно вызвать функцию с путями для демонстрации исходных файлов во вложенной папке. polyspace/examples/cxx/Bug_Finder_Example/sources папки установки MATLAB.

sourcePath = fullfile(polyspaceroot, 'polyspace', ... 
    'examples', 'cxx', 'Bug_Finder_Example', 'sources');
includePath = fullfile(polyspaceroot, 'polyspace', ... 
    'examples', 'cxx', 'Bug_Finder_Example', 'sources');
[status, resultsSummary] = runPolyspace(sourcePath, includePath);

Функция определяется следующим образом.

function [status, resultsSummary] = runPolyspace(sourcePath, libPath)
% runPolyspace takes two string arguments: source and include folder.
% The files in the source folder are analyzed for defects.
% If one or more files fail to compile, the errors are saved in a log.
% A warning on the screen indicates that compilation errors occurred.

    proj = polyspace.Project;

    % Specify sources
    proj.Configuration.Sources = {fullfile(sourcePath,'*')};
    
    % Specify compiler and paths to libraries
    proj.Configuration.TargetCompiler.Compiler = 'gnu4.9';
    proj.Configuration.EnvironmentSettings.IncludeFolders = {fullfile(libPath,'*')};
        
    
    % Run analysis
    runMode = 'bugFinder';
    [logFileContent,status] = evalc('run(proj, runMode)');
    
    % Open file for writing errors
    errorFile = fopen('error.log','wt+');
    
    % Check log file for compilation errors
    numErrors = 0;
    
    log = strsplit(logFileContent,'\n');
    errorLines = find(contains(log, {'Error:'}, 'IgnoreCase', true));
    for ii=1:numel(errorLines)
          fprintf(errorFile, '%s\n', log{errorLines(ii)});
          numErrors = numErrors + 1;
    end
    
    if numErrors
        warning('%d compilation error(s). See error.log for details.', numErrors);  
    end
             
    fclose(errorFile);
    
    % Read results
    resObj = proj.Results;
    resultsSummary = getSummary(resObj, 'defects');
    

Журнал анализа также записывается в файл Polyspace_R20##n_ProjectName_date-time.log. Вместо ввода выходных данных из окна команд можно выполнить поиск в этом файле.

Этот сценарий можно адаптировать для других целей. Например, можно записывать предупреждения в дополнение к ошибкам. Строки с предупреждениями начинаются с warning:. Предупреждения указывают на ситуации, когда анализ продолжается, несмотря на проблему. Анализ делает предположение о необходимости проработки этого вопроса. Если предположение неверно, можно увидеть ошибки позже или в редких случаях, неверные результаты анализа.

См. также

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