Scons自动化构建工具User Manual V4.3.0

python

需积分: 28 4 浏览量更新于2024-07-06 收藏 2.72MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

Scons用户手册V4.3.0 Scons是一个开放源码、以Python语言编码的自动化构建工具，可以将SCons看作是经典Make实用程序的改进的、跨平台的替代品。下面是Scons用户手册V4.3.0中的一些重要知识点： 1. Scons的基本概念：Scons是一个基于Python的自动化构建工具，可以自动地生成makefile文件，並且支持跨平台的构建。 2. Scons的优点：Scons的优点在于它可以跨平台地构建项目，并且可以自动地生成makefile文件，使得开发者可以更方便地管理项目的构建过程。 3. Scons的应用场景：Scons可以应用于各种类型的项目，包括C/C++项目、Python项目、Java项目等。 4. Scons的配置文件：Scons的配置文件通常以SConstruct或SConscript结尾，这些文件定义了项目的构建规则和依赖关系。 5. Scons的命令行参数：Scons支持多种命令行参数，例如-s、-c、-n等，用于控制构建过程。 6. Scons的环境变量：Scons支持环境变量的设置，例如CC、CXX、LINK等，可以用来控制构建过程中的编译器和链接器。 7. Scons的构建规则：Scons的构建规则可以通过SConstruct或SConscript文件来定义，包括源文件的编译、目标文件的生成、库文件的链接等。 8. Scons的依赖关系：Scons可以自动地分析项目的依赖关系，并生成正确的构建顺序。 9. Scons的跨平台支持：Scons支持多种平台，包括Windows、Linux、Mac OS等，可以在不同的平台上构建项目。 10. Scons的插件机制：Scons支持插件机制，可以通过插件来扩展Scons的功能，例如支持新的编译器或新的构建规则。在Scons用户手册V4.3.0中，我们可以看到许多关于Scons的详细信息，包括Scons的安装、配置、使用等方面的内容。从给定的文件信息中，可以看到Scons用户手册V4.3.0的部分内容，包括agg_renderer.os、agg/src、graphics.os、font_set.os等，这些文件都是Scons构建过程中的一些重要组件。 Scons是一个功能强大且灵活的自动化构建工具，能够满足各种项目的构建需求。

资源详情

资源推荐

2 Simple Builds

In this chapter, you will see several examples of very simple build configurations using SCons, which will demonstrate

how easy it is to use SCons to build programs from several different programming languages on different types of

systems.

2.1. Building Simple C / C++ Programs

Here's the famous "Hello, World!" program in C:

int

main()

{

printf("Hello, world!\n");

}

And here's how to build it using SCons. Save the code above into hello.c, and enter the following into a file named

SConstruct:

Program('hello.c')

This minimal configuration file gives SCons two pieces of information: what you want to build (an executable

program), and the input file from which you want it built (the hello.c file). Program is a builder method, a Python

call that tells SCons that you want to build an executable program.

That's it. Now run the scons command to build the program. On a POSIX-compliant system like Linux or UNIX,

you'll see something like:

% scons

scons: Reading SConscript files ...

scons: done reading SConscript files.

scons: Building targets ...

cc -o hello.o -c hello.c

cc -o hello hello.o

scons: done building targets.

On a Windows system with the Microsoft Visual C++ compiler, you'll see something like:

Building Object Files

C:\>scons

scons: Reading SConscript files ...

scons: done reading SConscript files.

scons: Building targets ...

cl /Fohello.obj /c hello.c /nologo

link /nologo /OUT:hello.exe hello.obj

embedManifestExeCheck(target, source, env)

scons: done building targets.

First, notice that you only need to specify the name of the source file, and that SCons correctly deduces the names of

the object and executable files to be built from the base of the source file name.

Second, notice that the same input SConstruct file, without any changes, generates the correct output file names

on both systems: hello.o and hello on POSIX systems, hello.obj and hello.exe on Windows systems.

This is a simple example of how SCons makes it extremely easy to write portable software builds.

(Note that we won't provide duplicate side-by-side POSIX and Windows output for all of the examples in this guide;

just keep in mind that, unless otherwise specified, any of the examples should work equally well on both types of

systems.)

2.2. Building Object Files

The Program builder method is only one of many builder methods that SCons provides to build different types of

files. Another is the Object builder method, which tells SCons to build an object file from the specified source file:

Object('hello.c')

Now when you run the scons command to build the program, it will build just the hello.o object file on a POSIX

system:

% scons

scons: Reading SConscript files ...

scons: done reading SConscript files.

scons: Building targets ...

cc -o hello.o -c hello.c

scons: done building targets.

And just the hello.obj object file on a Windows system (with the Microsoft Visual C++ compiler):

C:\>scons

scons: Reading SConscript files ...

scons: done reading SConscript files.

scons: Building targets ...

cl /Fohello.obj /c hello.c /nologo

scons: done building targets.

2.3. Simple Java Builds

SCons also makes building with Java extremely easy. Unlike the Program and Object builder methods, however,

the Java builder method requires that you specify the name of a destination directory in which you want the class

files placed, followed by the source directory in which the .java files live:

The SConstruct File

Notice that SCons changes its output to tell you that it is Cleaning targets ... and done cleaning

targets.

2.5. The SConstruct File

If you're used to build systems like Make you've already figured out that the SConstruct file is the SCons equivalent

of a Makefile. That is, the SConstruct file is the input file that SCons reads to control the build.

2.5.1. SConstruct Files Are Python Scripts

There is, however, an important difference between an SConstruct file and a Makefile: the SConstruct file

is actually a Python script. If you're not already familiar with Python, don't worry. This User's Guide will introduce

you step-by-step to the relatively small amount of Python you'll need to know to be able to use SCons effectively.

And Python is very easy to learn.

One aspect of using Python as the scripting language is that you can put comments in your SConstruct file using

Python's commenting convention; that is, everything between a '#' and the end of the line will be ignored:

# Arrange to build the "hello" program.

Program('hello.c') # "hello.c" is the source file.

You'll see throughout the remainder of this Guide that being able to use the power of a real scripting language can

greatly simplify the solutions to complex requirements of real-world builds.

2.5.2. SCons Functions Are Order-Independent

One important way in which the SConstruct file is not exactly like a normal Python script, and is more like a

Makefile, is that the order in which the SCons functions are called in the SConstruct file does not affect the

order in which SCons actually builds the programs and object files you want it to build

. In other words, when you

call the Program builder (or any other builder method), you're not telling SCons to build the program at that moment.

Instead, you're telling SCons what you want accomplished, and it's up to SCons to figure out how to do that, and to

take those steps if/when it's necessary. We'll learn more about how SCons decides when building or rebuilding a target

is necessary in Chapter 6, Dependencies, below.

SCons reflects this distinction between calling a builder method like Program and actually building the program

by printing the status messages that indicate when it's "just reading" the SConstruct file, and when it's actually

building the target files. This is to make it clear when SCons is executing the Python statements that make up the

SConstruct file, and when SCons is actually executing the commands or other actions to build the necessary files.

Let's clarify this with an example. Python has a print function that prints a string of characters to the screen. If we

put print calls around our calls to the Program builder method:

print("Calling Program('hello.c')")

Program('hello.c')

print("Calling Program('goodbye.c')")

Program('goodbye.c')

print("Finished calling Program()")

In programming parlance, the SConstruct file is declarative, meaning you tell SCons what you want done and let it figure out the order in

which to do it, rather than strictly imperative, where you specify explicitly the order in which to do things.

Making the SCons Output Less Verbose

Then when we execute SCons, we see the output from calling the print function in between the messages about

reading the SConscript files, indicating that is when the Python statements are being executed:

% scons

scons: Reading SConscript files ...

Calling Program('hello.c')

Calling Program('goodbye.c')

Finished calling Program()

scons: done reading SConscript files.

scons: Building targets ...

cc -o goodbye.o -c goodbye.c

cc -o goodbye goodbye.o

cc -o hello.o -c hello.c

cc -o hello hello.o

scons: done building targets.

Notice that SCons built the goodbye program first, even though the "reading SConscript" output shows that we

called Program('hello.c') first in the SConstruct file.

Notice also that SCons was able to infer a lot of information from the two Program calls. Because hello.c and

goodbye.c were recognized as C-language source files, it knew to build the intermediate target files hello.o and

goodbye.o and the final files hello and goodbye It was not necessary to program scons beyond just calling

Program.

2.6. Making the SCons Output Less Verbose

You've already seen how SCons prints some messages about what it's doing, surrounding the actual commands used

to build the software:

C:\>scons

scons: Reading SConscript files ...

scons: done reading SConscript files.

scons: Building targets ...

cl /Fohello.obj /c hello.c /nologo

link /nologo /OUT:hello.exe hello.obj

embedManifestExeCheck(target, source, env)

scons: done building targets.

These messages emphasize the order in which SCons does its work: all of the configuration files (generically referred

to as SConscript files) are read and executed first, and only then are the target files built. Among other benefits,

these messages help to distinguish between errors that occur while the configuration files are read, and errors that

occur while targets are being built.

One drawback, of course, is that these messages clutter the output. Fortunately, they're easily disabled by using the

-Q option when invoking SCons:

C:\>scons -Q

cl /Fohello.obj /c hello.c /nologo

link /nologo /OUT:hello.exe hello.obj

embedManifestExeCheck(target, source, env)

Because we want this User's Guide to focus on what SCons is actually doing, we're going to use the -Q option to

remove these messages from the output of all the remaining examples in this Guide.

剩余336页未读，继续阅读

renjiajin

粉丝: 1
资源: 1

Scons自动化构建工具User Manual V4.3.0

scons用户手册

scons用户手册（英文）

scons用户指南中文版

\\site_scons\\site_tools"

scons: *** No SConstruct file found

Ubuntu下scons安装

rt-thread scons

scons -v /usr/bin/env: ‘python’: No such file or directory

centos7安装scons

scons环境变量的配置

scons找不到编译器

scons 怎么指定python3

python安装scons

python调用scons库

qt使用qnx的scons编译

使用sudo python2 setup.py install 安装的scons，如何卸载

python3: can't open file 'scons': [Errno 2] No such file or directory

scons 环境配置

最新资源