-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathentry-points-swift-uiapplicationmain-main.html
315 lines (269 loc) · 18.1 KB
/
entry-points-swift-uiapplicationmain-main.html
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
<!DOCTYPE html>
<html lang="en">
<head>
<script src="https://use.fontawesome.com/afd448ce82.js"></script>
<!-- Meta Tag -->
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<!-- SEO -->
<meta name="author" content="Bruno Rocha">
<meta name="keywords" content="Software, Engineering, Blog, Posts, iOS, Xcode, Swift, Articles, Tutorials, OBJ-C, Objective-C, Apple">
<meta name="description" content="In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new @main attribute brings to the table.">
<meta name="title" content="Entry Points in Swift: How @main and @UIApplicationMain work internally">
<meta name="url" content="https://swiftrocks.com/entry-points-swift-uiapplicationmain-main">
<meta name="image" content="https://swiftrocks.com/images/thumbs/thumb.jpg?4">
<meta name="copyright" content="Bruno Rocha">
<meta name="robots" content="index,follow">
<meta property="og:title" content="Entry Points in Swift: How @main and @UIApplicationMain work internally"/>
<meta property="og:image" content="https://swiftrocks.com/images/thumbs/thumb.jpg?4"/>
<meta property="og:description" content="In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new @main attribute brings to the table."/>
<meta property="og:type" content="website"/>
<meta property="og:url" content="https://swiftrocks.com/entry-points-swift-uiapplicationmain-main"/>
<meta name="twitter:card" content="summary_large_image"/>
<meta name="twitter:image" content="https://swiftrocks.com/images/thumbs/thumb.jpg?4"/>
<meta name="twitter:image:alt" content="Page Thumbnail"/>
<meta name="twitter:title" content="Entry Points in Swift: How @main and @UIApplicationMain work internally"/>
<meta name="twitter:description" content="In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new @main attribute brings to the table."/>
<meta name="twitter:site" content="@rockbruno_"/>
<!-- Favicon -->
<link rel="icon" type="image/png" href="images/favicon/iconsmall2.png" sizes="32x32" />
<link rel="apple-touch-icon" href="images/favicon/iconsmall2.png">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,200..900;1,200..900&display=swap" rel="stylesheet">
<link rel="canonical" href="https://swiftrocks.com/entry-points-swift-uiapplicationmain-main"/>
<!-- Bootstrap CSS Plugins -->
<link rel="stylesheet" type="text/css" href="css/bootstrap.css">
<!-- Prism CSS Stylesheet -->
<link rel="stylesheet" type="text/css" href="css/prism4.css">
<!-- Main CSS Stylesheet -->
<link rel="stylesheet" type="text/css" href="css/style48.css">
<link rel="stylesheet" type="text/css" href="css/sponsor4.css">
<!-- HTML5 shiv and Respond.js support IE8 or Older for HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://swiftrocks.com/entry-points-swift-uiapplicationmain-main"
},
"image": [
"https://swiftrocks.com/images/thumbs/thumb.jpg"
],
"datePublished": "2020-07-21T14:00:00+02:00",
"dateModified": "2020-07-21T14:00:00+02:00",
"author": {
"@type": "Person",
"name": "Bruno Rocha"
},
"publisher": {
"@type": "Organization",
"name": "SwiftRocks",
"logo": {
"@type": "ImageObject",
"url": "https://swiftrocks.com/images/thumbs/thumb.jpg"
}
},
"headline": "Entry Points in Swift: How @main and @UIApplicationMain work internally",
"abstract": "In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new @main attribute brings to the table."
}
</script>
</head>
<body>
<div id="main">
<!-- Blog Header -->
<!-- Blog Post (Right Sidebar) Start -->
<div class="container">
<div class="col-xs-12">
<div class="page-body">
<div class="row">
<div><a href="https://swiftrocks.com">
<img id="logo" class="logo" alt="SwiftRocks" src="images/bg/logo2light.png">
</a>
<div class="menu-large">
<div class="menu-arrow-right"></div>
<div class="menu-header menu-header-large">
<div class="menu-item">
<a href="blog">blog</a>
</div>
<div class="menu-item">
<a href="about">about</a>
</div>
<div class="menu-item">
<a href="talks">talks</a>
</div>
<div class="menu-item">
<a href="projects">projects</a>
</div>
<div class="menu-item">
<a href="software-engineering-book-recommendations">book recs</a>
</div>
<div class="menu-item">
<a href="games">game recs</a>
</div>
<div class="menu-arrow-right-2"></div>
</div>
</div>
<div class="menu-small">
<div class="menu-arrow-right"></div>
<div class="menu-header menu-header-small-1">
<div class="menu-item">
<a href="blog">blog</a>
</div>
<div class="menu-item">
<a href="about">about</a>
</div>
<div class="menu-item">
<a href="talks">talks</a>
</div>
<div class="menu-item">
<a href="projects">projects</a>
</div>
<div class="menu-arrow-right-2"></div>
</div>
<div class="menu-arrow-right"></div>
<div class="menu-header menu-header-small-2">
<div class="menu-item">
<a href="software-engineering-book-recommendations">book recs</a>
</div>
<div class="menu-item">
<a href="games">game recs</a>
</div>
<div class="menu-arrow-right-2"></div>
</div>
</div>
</div>
<div class="content-page" id="WRITEIT_DYNAMIC_CONTENT">
<!--WRITEIT_POST_NAME=Entry Points in Swift: How @main and @UIApplicationMain work internally-->
<!--WRITEIT_POST_HTML_NAME=entry-points-swift-uiapplicationmain-main-->
<!--Add here the additional properties that you want each page to possess.-->
<!--These properties can be used to change content in the template page or in the page itself as shown here.-->
<!--Properties must start with 'WRITEIT_POST'.-->
<!--Writeit provides and injects WRITEIT_POST_NAME and WRITEIT_POST_HTML_NAME by default.-->
<!--WRITEIT_POST_SHORT_DESCRIPTION=In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new @main attribute brings to the table.-->
<!--WRITEIT_POST_SITEMAP_DATE_LAST_MOD=2020-07-21T14:00:00+02:00-->
<!--WRITEIT_POST_SITEMAP_DATE=2020-07-21T14:00:00+02:00-->
<title>Entry Points in Swift: How @main and @UIApplicationMain work internally</title>
<div class="blog-post">
<div class="post-title-index">
<h1>Entry Points in Swift: How <code>@main</code> and <code>@UIApplicationMain</code> work internally</h1>
</div>
<div class="post-info">
<div class="post-info-text">
Published on 21 Jul 2020
</div>
</div>
<p>In this article, we'll see how Swift determines the entry point of an app, the different attributes used to alter this behavior in iOS, how they work internally, and what Swift 5.3's new <code>@main</code> attribute brings to the table.</p>
<h2>How Swift Scripts Work</h2>
<div class="sponsor-article-ad-auto hidden"></div>
<p>When executing Swift code from the command line, by default, the code will be read from top to bottom just like any other scripting language. While Swift scripts support everything you'd have in any other context, they have the additional advantage of being able to write expressions in a <b>global scope</b>:</p>
<pre><code>print("Hello")
struct MyStruct {
func foo() {}
}
MyStruct().foo()</code></pre>
<p>In an iOS app, by default, doing so would result in the <code>Expressions are not allowed at the top level</code> error, but in a scripted world where you want to execute something as possible, there's no point in preventing this behavior.</p>
<p>Deep down, the ability to call code globally is just a cool syntax sugar. What is really happening is that Swift is abstracting your global code inside a fake <code>main</code> C function:</p>
<pre><code>func main(argc: Int32, argv: UnsafeMutablePointer<UnsafeMutablePointer<Int8>?>) -> Int32 {
print("Hello")
struct MyStruct {
func foo() {}
}
MyStruct().foo()
}</code></pre>
<p>Swift uses clang internally to compile and provide interoperability with C/C++/Objective-C, so it's natural that the starting point of a script/app mimicks it as well. You can check this with <code>swiftc (file) -emit-sil</code>, which will print Swift's Intermediate Language representation of your code after optimizing and generating any additional code it needs. In this case, we'll see a definition for a <code>main</code> function and our script's contents inside of it.</p>
<pre><code>sil @main
// a bunch of stuff that defines your top-level code!</code></pre>
<p>Interestingly enough, it's not possible for you to "steal" and define your own main function in that context. The generated main function is literally symbolized as <code>main</code>, while anything you define will internally have its symbol <b>mangled</b> (an unique identifier for your function or class, based on the context where it was defined), like <code>s4MyApp4mainCACycfc</code>.</p>
<p>This is what happens when your Swift script/binary only contains one file, but what if it contains <b>multiple</b> files?</p>
<p>In this case, as we can't have multiple starting points, we must designate one of them as the <b>main</b> one. Like before, the main file will be the entry point of the app and gain access to global expressions, but now, as expected, any additional file will have to follow your usual Swift rules. In Swift, designating the main file is just a matter of naming it <code>main.swift</code>.</p>
<pre><code>swiftc main.swift anotherFile.swift</code></pre>
<h2><code>@UIApplicationMain</code> -- When the entry point needs to be controlled</h2>
<p>But not all kinds of programs fit into this top-bottom code execution format -- for example, in iOS, the execution of the app relies on running and maintaining an <code>UIApplication</code> instance, a process that is the same for every single iOS app. This initial process of booting an <code>UIApplication</code> is abstracted by UIKit, and there's no reason for you as an user to have to worry about it, specially considering that this is the very first thing your app should do. For this reason, you could argue that handling this responsability to the user could even have <b>negative</b> consequences. Imagine accidentally shipping a version where your app doesn't boot at all!</p>
<p>To prevent this issue from happening, Apple thought that if UIKit is responsible for providing the code necessary to boot an iOS app, then it should probably <b>get its hands dirty and do it itself</b>. The Swift compiler then started supporting two new special attributes: <code>@UIApplicationMain</code> and <code>@NSApplicationMain</code> (for macOS).</p>
<p>These attributes are magical, but they don't deviate from what we already know. Their purpose is to <b>automatically generate an entry point</b>, and internally, what happens is that the presence of these attributes will result in a fake <code>main</code> function being added to your binary:</p>
<pre><code>func main(argc: Int32, argv: UnsafeMutablePointer<UnsafeMutablePointer<Int8>?>) -> Int32 {
return UIApplicationMain(argc, argv, nil, ClassName)
}</code></pre>
<p>The content of the function depends on the attribute you used, but as you can expect, it simply initializes your iOS app.</p>
<p>You might know <code>UIApplicationMain()</code> if you ever needed to use a subclass of an <code>UIApplication</code> in your app -- this is the function that bootstraps an iOS app, and you can use the third and fourth arguments to change the classes you want to use as your <code>UIApplication</code> and <code>UIApplicationDelegate</code>. This means that there's nothing special about the <code>@UIApplicationMain</code> attribute, and you can reproduce what the compiler is doing by removing it and creating your own <code>main.swift</code> file. This is a legit technique to fine-tune the initialization of your app, which you can use to run code before your app launches (literally).</p>
<pre><code>UIHooks.swizzleEverything()
UIApplicationMain(CommandLine.argc, CommandLine.unsafeArgv, nil, "AppDelegate")</code></pre>
<p>As a fake <code>main</code> function is emitted as a result of using the <code>@UIApplicationMain</code> attribute, you can't have <b>both</b> the attribute and a <code>main.swift</code> file. Trying to use both will result in a duplicated symbol error, and in some situations the compiler will even give you a specific <code>attribute cannot be used in a module that contains top-level code</code> error.</p>
<h2>Swift 5.3 and <code>@main</code></h2>
<p>Many years later, it was realized that UIKit was not the only framework that benefitted from controlling the entry point. Many frameworks for Swift CLI tools involve some sort of initial setup, and so it would be great if the language provided a standard way to replicating what was currently hardcoded as <code>@UIApplicationMain</code>. Finally, in Swift 5.3, the <code>@main</code> attribute was added to allow developers to control this behavior.</p>
<pre><code>@main struct MyScript {
static func main() throws {
print("SwiftRocks!")
}
}</code></pre>
<p><code>@main</code> works similarly to a protocol -- when added, you must define a <code>main()</code> method that will serve as the entry point for your Swift code. Apart from that, <code>@main</code> works precisely like <code>@UIApplicationMain</code>. The fake <code>main</code> function is still emitted, but instead of returning the hardcoded UIKit behavior, it executes the function that you defined as a result of adding the attribute to a type. As seen in WWDC 2020, the new <code>@main</code> attribute is used by SwiftUI and the new Widgets extension to abstract the definition of their entry points.</p>
<p>One particularly interesting use of it is in Apple's <b>swift-argument-parser</b> library, which is a tool for creating commands and arguments for CLI tools. Before Swift 5.3, you had to manually initialize your tool by calling its main command's <code>main()</code> method from the library, but now, you can simply attach the new attribute to mark it as the starting point.</p>
<p>Before:</p>
<pre><code>struct Repeat: ParsableCommand {
@Argument(help: "The phrase to repeat.")
var phrase: String
mutating func run() throws {
for _ in 1...5 {
print(phrase)
}
}
}
Repeat.main()</code></pre>
<div class="sponsor-article-ad-auto hidden"></div>
<p>Post Swift 5.3:</p>
<pre><code>@main struct Repeat: ParsableCommand {
@Argument(help: "The phrase to repeat.")
var phrase: String
mutating func run() throws {
for _ in 1...5 {
print(phrase)
}
}
}</code></pre>
<p>Because of this addition, using <code>@UIApplicationMain</code> is now officially deprecated as Apple allows you to use the new <code>@main</code> attribute in your AppDelegates (except in the second Xcode 12 beta, where the feature was temporarily disabled).</p>
</div></div>
<div class="blog-post footer-main">
<div class="footer-logos">
<a href="https://swiftrocks.com/rss.xml"><i class="fa fa-rss"></i></a>
<a href="https://twitter.com/rockbruno_"><i class="fa fa-twitter"></i></a>
<a href="https://github.com/rockbruno"><i class="fa fa-github"></i></a>
</div>
<div class="footer-text">
© 2025 Bruno Rocha
</div>
<div class="footer-text">
<p><a href="https://swiftrocks.com">Home</a> / <a href="blog">See all posts</a></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<!-- Blog Post (Right Sidebar) End -->
</div>
</div>
</div>
<!-- All Javascript Plugins -->
<script type="text/javascript" src="js/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
<script type="text/javascript" src="js/prism4.js"></script>
<!-- Main Javascript File -->
<script type="text/javascript" src="js/scripts30.js"></script>
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-H8KZTWSQ1R"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-H8KZTWSQ1R');
</script>
</body>
</html>