1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
# Swift Debugger and REPL
|| **Status** |
|---|---|
|**macOS** |[](https://ci.swift.org/job/oss-lldb-incremental-osx)|
|**Ubuntu 14.04** |[](https://ci.swift.org/job/oss-lldb-incremental-linux-ubuntu-14_04)|
|**Ubuntu 16.04** |[](https://ci.swift.org/job/oss-lldb-incremental-linux-ubuntu-16_04)|
|**Ubuntu 18.04** |[](https://ci.swift.org/job/oss-lldb-incremental-linux-ubuntu-18_04)|
**Welcome to the Swift Debugger and REPL!**
Swift is a new, high performance systems programming language. It has a clean
and modern syntax, offers seamless access to existing C and Objective-C
code and frameworks, and is memory safe (by default).
This repository covers the Swift Debugger and REPL support, built on
top of the LLDB Debugger.
# Building LLDB for Swift
To build LLDB for Swift, check out the swift repository and follow
the instruction listed there. You can build lldb passing the --lldb
flag to it. Example invocation:
```
mkdir myswift
cd myswift
git clone https://github.com/apple/swift.git swift
./swift/utils/update-checkout
./llvm-project/lldb/scripts/macos-setup-codesign.sh
./swift/utils/build-script -r --lldb
```
Note: The codesigning setup script needs to be run only once. It's not required
if `build-script` is run with the `--lldb-use-system-debugserver` flag.
# Contribution Subtleties
The swift-lldb project enhances the core LLDB project developed under
the [LLVM Project][llvm]. Swift support in the debugger is added via
the existing source-level plugin infrastructure, isolated to files that
are newly introduced in the lldb-swift repository.
Files that come from the [core LLDB project][lldb] can be readily
identified by their use of the LLVM comment header. As no local
changes should be made to any of these files, follow the standard
[guidance for upstream changes][upstream].
[lldb]: http://lldb.llvm.org "LLDB debugger"
[llvm]: http://llvm.org "The LLVM Project"
[upstream]: http://swift.org/contributing/#llvm-and-swift "Upstream LLVM changes"
|
