文件跟踪器日志文件格式 [英] File Tracker Log file format

问题描述

在Visual Studio 2010中，增量构建是使用文件跟踪器(Microsoft.Build.Utilities.FileTracker)完成的.看来，这是在中间目录上创建这些* .1.tlog文件的原因.

In Visual Studio 2010 incremental builds are done using the File Tracker (Microsoft.Build.Utilities.FileTracker). It seems that it is responsible to the creation of these *.1.tlog files on the intermediate directory.

我找不到对这些.tlog文件语法的任何引用.
它们包含跟踪器跟踪某些工具的执行时读取/写入的文件的路径列表，以便检查应在增量版本中编译哪些文件.但是，这些文件还包含一些特殊字符，例如"^"和"|".
我注意到的另一件事是，有时这些文件是从Visual Studio目标文件中编辑的.例如，在CustomBuildStep目标上的Microsoft.CppCommon.targets中，我找到了以下行:

I couldn't find any reference to the syntax of these .tlog files.
They contain a list of paths to files that are read/written while the tracker tracks the execution of some tool, in order to check which files should be compiled in an incremental build. However, these files also contain some special characters such as "^" and "|".
Another thing I noticed was that these files are sometimes edited from Visual Studio targets files. For example, in Microsoft.CppCommon.targets on CustomBuildStep target I found the following line:

 <!-- Appended tlog to track custom build events -->
    <WriteLinesToFile File="$(IntDir)$(ProjectName).write.1.tlog" Lines="@(CustomBuildStep->'^%(Identity)');@(CustomBuildStep->MetaData('Outputs')->FullPath()->Distinct())"/>

因此，这可能意味着项目文件取决于自定义构建步骤的输出.

So this probably means that the project file is dependent on the custom build step outputs.

我的问题是:

• 有人知道.tlog文件语法的引用吗?
• 在哪种情况下，Visual Studio上使用跟踪器日志?我知道使用CL的CL也许还有Link任务，但是似乎Visual Studio IDE本身使用它来决定是否为某个项目完全运行msbuild.

谢谢

CanonicalTrackedInputFiles Class 被记录为"文件跟踪"用于以标准格式或已加根(^)以使其规范化的日志格式的.read.跟踪日志解释器"
当我有时间的时候，我会进一步研究它.也许此类和 Microsoft.Build.Utilities 下的其他类可以用来帮助我们使用tlog文件，而不是直接使用原始文本tlog文件.

CanonicalTrackedInputFiles Class is document as "the filetracking log interpreter for .read. tracking logs in canonical form or those that have been rooted (^) to make them canonical"
When I have time I'll dig into it a bit more. Perhaps this class and others under Microsoft.Build.Utilities could be used to help us work with tlog files instead of working with the raw text tlog files directly.

另请参见: CanonicalTrackedOutputFiles Class ， FlatTrackingData Class 当然是 FileTracker Class .

See also: CanonicalTrackedOutputFiles Class, FlatTrackingData Class and of course FileTracker Class.

推荐答案

现在已在此处记录了tlog文件格式: https://docs.microsoft.com/en-us/visualstudio/extensibility/visual-cpp-project-extensibility? view = vs-2017#tlog文件

The tlog file format is now documented here: https://docs.microsoft.com/en-us/visualstudio/extensibility/visual-cpp-project-extensibility?view=vs-2017#tlog-files

读取.tlog格式

读取 .tlog文件( .read. .tlog)包含有关源文件及其依赖项的信息.

Read .tlog format

Read .tlog files (.read..tlog) contain information about source files and their dependencies.

行首的插入符号(^)表示一个或多个源.共享相同依存关系的源由竖线(|)分隔.

A caret (^) at the beginning of a line indicates one or more sources. Sources that share the same dependencies are separated by a vertical bar (|).

依赖文件在源之后列出，每个文件单独一行.所有文件名都是完整路径.

Dependency files are listed after the sources, each on its own line. All file names are full paths.

这篇关于文件跟踪器日志文件格式的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！