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
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
|
<html devsite><head>
<title>链接器命名空间</title>
<meta name="project_path" value="/_project.yaml"/>
<meta name="book_path" value="/_book.yaml"/>
</head>
<body>
<!--
Copyright 2017 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<p>动态链接器解决了 Treble VNDK 设计中的两个难题：</p>
<ul>
<li>将 SP-HAL 共享库及其依赖项（包括 VNDK-SP 库）加载到框架进程中。这种情况下应该有一些防止出现符号冲突的机制。</li>
<li><code>dlopen()</code> 和 <code>android_dlopen_ext()</code> 可能会引入一些在编译时不可见的运行时依赖项，这些依赖项使用静态分析很难检测到。</li>
</ul>
<p>这两个难题可以通过链接器命名空间机制来解决。<em></em>链接器命名空间机制由动态链接器提供，可以隔离不同链接器命名空间中的共享库，以确保具有相同库名称和不同符号的库不会发生冲突。</p>
<p>另一方面，链接器命名空间机制可提供相应的灵活性，从而将由一个链接器命名空间导出的某些共享库用于另一个链接器命名空间。这些导出的共享库可能会成为对其他程序公开的应用编程接口，同时在其链接器命名空间中隐藏实现细节。</p>
<p>例如，<code>/system/lib[64]/libcutils.so</code> 和 <code>/system/lib[64]/vndk-sp-${VER}/libcutils.so</code> 是两个共享库。这两个库可能有不同的符号。它们将加载到不同的链接器命名空间中，以便框架模块可以依赖于 <code>/system/lib[64]/libcutils.so</code>，而 SP-HAL 共享库则可以依赖于 <code>/system/lib[64]/vndk-sp-${VER}/libcutils.so</code>。</p>
<p>另一方面，<code>/system/lib[64]/libc.so</code> 是由一个链接器命名空间导出而后又被导入到许多链接器命名空间中的公共库。<code>/system/lib[64]/libc.so</code> 的依赖项（例如 <code>libnetd_client.so</code>）将被加载到 <code>/system/lib[64]/libc.so</code> 所在的命名空间中。其他命名空间将无法访问这些依赖项。这种机制会在提供公共接口的同时封装实现细节。</p>
<h2 id="how-does-it-work">工作原理</h2>
<p>动态链接器负责加载 <code>DT_NEEDED</code> 条目中指定的共享库，或由 <code>dlopen()</code> 或 <code>android_dlopen_ext()</code> 的参数指定的共享库。在这两种情况下，动态链接器都会找出调用程序所在的链接器命名空间，并尝试将相关依赖项加载到同一个链接器命名空间中。如果动态链接器无法将共享库加载到指定的链接器命名空间中，它会向关联的链接器命名空间索取导出的共享库。<em></em></p>
<h2 id="configuration-file-format">配置文件格式</h2>
<p>配置文件格式取决于 INI 文件格式。典型的配置文件如下所示：</p>
<pre class="prettyprint">
dir.system = /system/bin
dir.vendor = /vendor/bin
[system]
additional.namespaces = sphal
namespace.default.isolated = true
namespace.default.search.paths = /system/${LIB}:/vendor/${LIB}
namespace.default.permitted.paths = /system/${LIB}:/vendor/${LIB}
namespace.sphal.isolated = true
namespace.sphal.visible = true
namespace.sphal.search.paths = /vendor/${LIB}
namespace.sphal.permitted.paths = /vendor/${LIB}
namespace.sphal.links = default
namespace.sphal.link.default.shared_libs = libc.so:libm.so
[vendor]
namespace.default.isolated = false
namespace.default.search.paths = /vendor/${LIB}:/system/${LIB}
namespace.default.permitted.paths = /vendor/${LIB}:/system/${LIB}
</pre>
<p>首先，<code>ld.config.txt</code> 的开头有几个 <code>dir.${section}</code> 属性：</p>
<pre class="prettyprint">
dir.${section} = /path/to/bin/directory
</pre>
<p>这些属性决定了将应用于相应进程的一系列规则。例如，如果主可执行文件位于 <code>/system/bin</code> 中，则会应用 <code>[system]</code> 中的规则。<em></em>同样，如果主可执行文件位于 <code>/vendor/bin</code> 中，则会应用 <code>[vendor]</code> 中的规则。<em></em></p>
<p>其次，除了 <code>default</code> 链接器命名空间外，<code>addition.namespaces</code> 还为每个部分指定了将由动态链接器创建的额外链接器命名空间（用英文逗号分隔）：</p>
<pre class="prettyprint">
additional.namespaces = namespace1,namespace2,namespace3
</pre>
<p>在上述示例中，动态链接器为 <code>/system/bin</code> 中的可执行文件创建了两个链接器命名空间（<code>default</code> 和 <code>sphal</code>）。</p>
<p>再次，对于每个链接器命名空间，可以配置以下属性：</p>
<pre class="prettyprint">
namespace.${name}.search.paths = /path1/${LIB}:/path2/${LIB}
namespace.${name}.permitted.paths = /path1:/path2
namespace.${name}.isolated = true|false
namespace.${name}.links = namespace1,namespace2
namespace.${name}.link.${other}.shared_libs = lib1.so:lib2.so
namespace.${name}.link.${other}.allow_all_shared_libs = true
namespace.${name}.visible = true|false
</pre>
<p><code>namespace.${name}.search.paths</code> 表示将附加到库名称前面的目录。各目录之间用英文冒号隔开。
<code>${LIB}</code> 是一个特殊的占位符。如果相应进程正在运行 32 位可执行文件，则 <code>${LIB}</code> 将被替换为 <code>lib</code>。同样，如果相应进程正在运行 64 位可执行文件，则 <code>${LIB}</code> 将被替换为 <code>lib64</code>。</p>
<p>在上述示例中，如果 <code>/system/bin</code> 中的 64 位可执行文件与 <code>libexample.so</code> 相关联，则动态链接器会首先搜索 <code>/system/lib64/libexample.so</code>。如果找不到 <code>/system/lib64/libexample.so</code>，则动态链接器会搜索 <code>/vendor/lib64/libexample.so</code>。</p>
<p>如果 <code>namespace.${name}.isolated</code> 为 <code>true</code>，则动态链接器仅会加载 <code>namespace.${name}.search.paths</code> 中指定目录下的共享库，或 <code>namespace.${name}.permitted.paths</code> 中指定目录下的共享库。</p>
<p>在上述示例中，在 <code>sphal</code> 链接器命名空间中加载的共享库将无法关联到 <code>/system/lib[64]</code> 中的共享库，因为 <code>namespace.sphal.isolated</code> 为 <code>true</code> 并且 <code>/system/lib[64]</code> 既不在 <code>namespace.sphal.permitted.paths</code> 中也不在 <code>namespace.sphal.search.paths</code> 中。</p>
<p><code>namespace.${name}.links</code> 指定了 <code>${name}</code> 链接器命名空间关联到的链接器命名空间列表（以英文逗号分隔）。</p>
<p>在上述示例中，<code>namespace.sphal.links</code> 指定 <code>sphal</code> 链接器命名空间关联到 <code>default</code> 链接器命名空间。</p>
<p><code>namespace.${name}.link.${other}.shared_libs</code> 会指定可能会利用后备链接的共享库名称（用英文冒号分隔）。如果某个共享库无法加载到 <code>${name}</code> 链接器命名空间中，并且其名称位于 <code>namespace.${name}.link.${other}.shared_libs</code> 中，则动态链接器会尝试从 <code>${other}</code> 链接器命名空间导入该库。</p>
<p>在上述示例中，<code>namespace.sphal.link.default.shared_libs</code> 指定 <code>libc.so</code> 和 <code>libm.so</code> 可以由 <code>default</code> 链接器命名空间导出。如果在 <code>sphal</code> 链接器命名空间中加载的共享库关联到 <code>libc.so</code>，并且动态链接器在 <code>/vendor/lib[64]</code> 中找不到 <code>libc.so</code>，则动态链接器会遍历后备链接，并查找由 <code>default</code> 链接器命名空间导出的 <code>libc.so</code>。</p>
<p>如果 <code>namespace.${name}.link.${other}.allow_all_shared_libs</code> 为 <code>true</code>，则所有共享库名称均可以利用后备链接。如果某个共享库无法加载到 <code>${name}</code> 链接器命名空间中，则动态链接器会尝试从 <code>${other}</code> 链接器命名空间导入该库。</p>
<p>如果 <code>namespace.${name}.visible</code> 为 <code>true</code>，该程序将能够获取链接器命名空间句柄，该句柄随后可传递到 <code>android_dlopen_ext()</code>。</p>
<p>在上述示例中，<code>namespace.sphal.visible</code> 为 <code>true</code>，以便 <code>android_load_sphal_library()</code> 可以明确要求动态链接器加载 <code>sphal</code> 链接器命名空间中的共享库。</p>
<h2 id="linker-namespace-isolation">链接器命名空间隔离</h2>
<p><code>${android-src}/system/core/rootdir/etc</code> 中有三种配置。系统会根据 <code>BoardConfig.mk</code> 中 <code>PRODUCT_TREBLE_LINKER_NAMESPACES</code>、<code>BOARD_VNDK_VERSION</code> 和 <code>BOARD_VNDK_RUNTIME_DISABLE</code> 的值选择不同的配置：</p>
<table>
<tbody><tr>
<th><code>PRODUCT_TREBLE_</code><br /><code>LINKER_NAMESPACES</code></th>
<th><code>BOARD_VNDK_</code><br /><code>VERSION</code></th>
<th><code>BOARD_VNDK_</code><br /><code>RUNTIME_DISABLE</code></th>
<th>选择的配置</th>
<th>VTS 要求</th>
</tr>
<tr>
<td rowspan="3"><code>true</code></td>
<td rowspan="2"><code>current</code></td>
<td><em>empty</em></td>
<td><code>ld.config.txt</code></td>
<td>搭载 Android P 的设备的必要配置。</td>
</tr>
<tr>
<td><code>true</code></td>
<td rowspan="2"><code>ld.config.vndk_lite.txt</code></td>
<td rowspan="2">搭载 Android 8.x 的设备的必要配置。</td>
</tr>
<tr>
<td><em>empty</em></td>
<td><em>any</em></td>
</tr>
<tr>
<td><code>false</code></td>
<td><em>any</em></td>
<td><em>any</em></td>
<td><code>ld.config.legacy.txt</code></td>
<td>适用于不支持 Treble 的设备</td>
</tr>
</tbody></table>
<p><code>${android-src}/system/core/rootdir/etc/ld.config.vndk_lite.txt</code> 会隔离 SP-HAL 和 VNDK-SP 共享库。在 Android 8.0 及更高版本中，当 <code>PRODUCT_TREBLE_LINKER_NAMESPACES</code> 为 <code>true</code> 时，该配置必须是动态链接器的配置文件。</p>
<p><code>${android-src}/system/core/rootdir/etc/ld.config.txt</code> 也会隔离 SP-HAL 和 VNDK-SP 共享库。此外，<code>ld.config.txt</code> 还会提供全面的动态链接器隔离。它可确保系统分区中的模块不依赖于供应商分区中的共享库，反之亦然。</p>
<p>在 Android 8.1 中，<code>ld.config.txt</code> 是默认配置文件，强烈建议您启用全面的动态链接器隔离。但是，如果在 Android 8.1 中需要清理的依赖项太多，您可以将 <code>BOARD_VNDK_RUNTIME_DISABLE</code> 添加到 <code>BoardConfig.mk</code> 中：</p>
<pre class="prettyprint">
BOARD_VNDK_RUNTIME_DISABLE := true
</pre>
<p>如果 <code>BOARD_VNDK_RUNTIME_DISABLE</code> 为 <code>true</code>，则会安装 <code>${android-src}/system/core/rootdir/etc/ld.config.vndk_lite.txt</code>。</p>
<h3 id="ld.config.txt">ld.config.txt</h3>
<p><code>ld.config.txt</code> 会隔离系统分区和供应商分区之间的共享库依赖项。下文概述了该配置文件与上一小节中提到的 <code>ld.config.txt</code> 相比有哪些不同：</p>
<ul>
<li>
<p>框架进程</p>
<ul>
<li>创建了四个命名空间（<code>default</code>、<code>vndk</code>、<code>sphal</code> 和 <code>rs</code>）。</li>
<li>系统会隔离所有命名空间。</li>
<li>将系统共享库加载到 <code>default</code> 命名空间中。</li>
<li>将 SP-HAL 加载到 <code>sphal</code> 命名空间中。</li>
<li>将 VNDK-SP 共享库加载到 <code>vndk</code> 命名空间中。</li>
</ul>
</li>
<li>
<p>供应商进程</p>
<ul>
<li>创建了三个命名空间（<code>default</code>、<code>vndk</code> 和 <code>system</code>）。</li>
<li>系统会隔离 <code>default</code> 命名空间。</li>
<li>将供应商共享库加载到 <code>default</code> 命名空间中。</li>
<li>将 VNDK 和 VNDK-SP 共享库加载到 <code>vndk</code> 命名空间中。</li>
<li>将 LL-NDK 及其依赖项加载到 <code>system</code> 命名空间中。</li>
</ul>
</li>
</ul>
<p>链接器命名空间之间的关系如下图所示：</p>
<img src="../images/treble_vndk_linker_namespace3.png" alt="ld.config.txt 中描绘的链接器命名空间图表"/>
<figcaption>
<strong>图 1.</strong> 链接器命名空间隔离 (<code>ld.config.txt</code>)
</figcaption>
<p>在上图中，LL-NDK 和 VNDK-SP 代表以下共享库：<em></em><em></em></p>
<ul>
<li>
<em>LL-NDK</em>
<ul>
<li><code>libEGL.so</code></li>
<li><code>libGLESv1_CM.so</code></li>
<li><code>libGLESv2.so</code></li>
<li><code>libGLESv3.so</code></li>
<li><code>libandroid_net.so</code></li>
<li><code>libc.so</code></li>
<li><code>libdl.so</code></li>
<li><code>liblog.so</code></li>
<li><code>libm.so</code></li>
<li><code>libnativewindow.so</code></li>
<li><code>libneuralnetworks.so</code></li>
<li><code>libsync.so</code></li>
<li><code>libvndksupport.so</code></li>
<li><code>libvulkan.so</code></li>
</ul>
</li>
<li>
<em>VNDK-SP</em>
<ul>
<li><code>android.hardware.graphics.common@1.0.so</code></li>
<li><code>android.hardware.graphics.mapper@2.0.so</code></li>
<li><code>android.hardware.renderscript@1.0.so</code></li>
<li><code>android.hidl.memory@1.0.so</code></li>
<li><code>libRSCpuRef.so</code></li>
<li><code>libRSDriver.so</code></li>
<li><code>libRS_internal.so</code></li>
<li><code>libbase.so</code></li>
<li><code>libbcinfo.so</code></li>
<li><code>libc++.so</code></li>
<li><code>libcutils.so</code></li>
<li><code>libhardware.so</code></li>
<li><code>libhidlbase.so</code></li>
<li><code>libhidlmemory.so</code></li>
<li><code>libhidltransport.so</code></li>
<li><code>libhwbinder.so</code></li>
<li><code>libion.so</code></li>
<li><code>libutils.so</code></li>
<li><code>libz.so</code></li>
</ul>
</li>
</ul>
<p>下表列出了框架进程的命名空间配置（摘自 <code>ld.config.txt</code> 中的 <code>[system]</code> 部分）：</p>
<table>
<tbody><tr>
<th>命名空间</th>
<th>属性</th>
<th>值</th>
</tr>
<tr>
<td rowspan="3"><code>default</code></td>
<td><code>search.paths</code></td>
<td>
<code>/system/${LIB}</code><br />
<code>/product/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/system/${LIB}/drm</code><br />
<code>/system/${LIB}/extractors</code><br />
<code>/system/${LIB}/hw</code><br />
<code>/product/${LIB}</code><br />
<code>/system/framework</code><br />
<code>/system/app</code><br />
<code>/system/priv-app</code><br />
<code>/vendor/app</code><br />
<code>/vendor/priv-app</code><br />
<code>/oem/app</code><br />
<code>/odm/priv-app</code><br />
<code>/oem/app</code><br />
<code>/product/framework</code><br />
<code>/product/app</code><br />
<code>/product/priv-app</code><br />
<code>/data</code><br />
<code>/mnt/expand
</code></td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td rowspan="8"><code>sphal</code></td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default,vndk,rs</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td><code>link.vndk.shared_libs</code></td>
<td><em>VNDK-SP</em></td>
</tr>
<tr>
<td><code>link.rs.shared_libs</code></td>
<td><code>libRS_internal.so</code></td>
</tr>
<tr>
<td rowspan="7"><code>vndk</code>（适用于 VNDK-SP）</td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}/hw</code><br />
<code>/odm/${LIB}/egl</code><br />
<code>/vendor/${LIB}/hw</code><br />
<code>/vendor/${LIB}/egl</code><br />
<code>/system/${LIB}/vndk-sp-${VER}/hw</code>
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default</code>、<code>sphal</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td><code>link.default.allow_all_shared_libs</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td rowspan="7"><code>rs</code>（适用于 Renderscript）</td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code><br />
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code><br />
<code>/data</code>（适用于已编译的 RS 内核）
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default,vndk</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td>
<em>LL-NDK</em><br />
<code>libmediandk.so</code><br />
<code>libft2.so</code>
</td>
</tr>
<tr>
<td><code>link.vndk.shared_libs</code></td>
<td><em>VNDK-SP</em></td>
</tr>
</tbody></table>
<p>下表列出了供应商进程的命名空间配置（摘自 <code>ld.config.txt</code> 中的 <code>[vendor]</code> 部分）：</p>
<table>
<tbody><tr>
<th>命名空间</th>
<th>属性</th>
<th>值</th>
</tr>
<tr>
<td rowspan="7"><code>default</code></td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm</code><br />
<code>/vendor</code><br />
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>system</code>、<code>vndk</code></td>
</tr>
<tr>
<td><code>link.system.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td><code>link.vndk.shared_libs</code></td>
<td><em>VNDK</em>、<em>VNDK-SP</em>（供应商可用）</td>
</tr>
<tr>
<td rowspan="5"><code>vndk</code></td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}/vndk</code><br />
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}/vndk</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-${VER}</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code>
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>system</code>、<code>default</code></td>
</tr>
<tr>
<td><code>link.system.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td><code>link.default.allow_all_shared_libs</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td rowspan="2"><code>system</code></td>
<td><code>search.paths</code></td>
<td><code>/system/${LIB}</code></td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>false</code></td>
</tr>
</tbody></table>
<p>更多详情请见 <code>${android-src}/system/core/rootdir/etc/ld.config.txt</code>。</p>
<h3 id="ld.config.vndk_lite.txt">ld.config.vndk_lite.txt</h3>
<p>从 Android 8.0 开始，动态链接器将配置为隔离 SP-HAL 和 VNDK-SP 共享库，以使其符号不会与其他框架共享库发生冲突。链接器命名空间之间的关系如下所示：</p>
<img src="../images/treble_vndk_linker_namespace1.png" alt="ld.config.vndk_lite.txt 中描绘的链接器命名空间图表"/>
<figcaption>
<strong>图 2.</strong> 链接器命名空间隔离 (<code>ld.config.vndk_lite.txt</code>)
</figcaption>
<p><em></em><em></em>LL-NDK 和 VNDK-SP 代表以下共享库：
</p>
<ul>
<li>
<em>LL-NDK</em>
<ul>
<li><code>libEGL.so</code></li>
<li><code>libGLESv1_CM.so</code></li>
<li><code>libGLESv2.so</code></li>
<li><code>libc.so</code></li>
<li><code>libdl.so</code></li>
<li><code>liblog.so</code></li>
<li><code>libm.so</code></li>
<li><code>libnativewindow.so</code></li>
<li><code>libstdc++.so</code>（不在 <code>ld.config.txt</code> 中）</li>
<li><code>libsync.so</code></li>
<li><code>libvndksupport.so</code></li>
<li><code>libz.so</code>（已移到 <code>ld.config.txt</code> 中的 VNDK-SP）<em></em></li>
</ul>
</li>
<li>
<em>VNDK-SP</em>
<ul>
<li><code>android.hardware.graphics.common@1.0.so</code></li>
<li><code>android.hardware.graphics.mapper@2.0.so</code></li>
<li><code>android.hardware.renderscript@1.0.so</code></li>
<li><code>android.hidl.memory@1.0.so</code></li>
<li><code>libbase.so</code></li>
<li><code>libc++.so</code></li>
<li><code>libcutils.so</code></li>
<li><code>libhardware.so</code></li>
<li><code>libhidlbase.so</code></li>
<li><code>libhidlmemory.so</code></li>
<li><code>libhidltransport.so</code></li>
<li><code>libhwbinder.so</code></li>
<li><code>libion.so</code></li>
<li><code>libutils.so</code></li>
</ul>
</li>
</ul>
<p>下表列出了框架进程的命名空间配置（摘自 <code>ld.config.vndk_lite.txt</code> 中的 <code>[system]</code> 部分）：</p>
<table>
<tbody><tr>
<th>命名空间</th>
<th>属性</th>
<th>值</th>
</tr>
<tr>
<td rowspan="2"><code>default</code></td>
<td><code>search.paths</code></td>
<td>
<code>/system/${LIB}</code><br />
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code><br />
<code>/product/${LIB}</code>
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>false</code></td>
</tr>
<tr>
<td rowspan="8"><code>sphal</code></td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default,vndk,rs</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td><code>link.vndk.shared_libs</code></td>
<td><em>VNDK-SP</em></td>
</tr>
<tr>
<td><code>link.rs.shared_libs</code></td>
<td><code>libRS_internal.so</code></td>
</tr>
<tr>
<td rowspan="6"><code>vndk</code>（适用于 VNDK-SP）</td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}/hw</code><br />
<code>/odm/${LIB}/egl</code><br />
<code>/vendor/${LIB}/hw</code><br />
<code>/vendor/${LIB}/egl</code><br />
<code>/system/${LIB}/vndk-sp-${VER}/hw</code><br />
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td><em>LL-NDK</em></td>
</tr>
<tr>
<td rowspan="7"><code>rs</code>（适用于 Renderscript）</td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code><br />
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code>
</td>
</tr>
<tr>
<td><code>permitted.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/vendor/${LIB}</code><br />
<code>/data</code>（适用于已编译的 RS 内核）
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>visible</code></td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>links</code></td>
<td><code>default,vndk</code></td>
</tr>
<tr>
<td><code>link.default.shared_libs</code></td>
<td>
<em>LL-NDK</em><br />
<code>libmediandk.so</code><br />
<code>libft2.so</code>
</td>
</tr>
<tr>
<td><code>link.vndk.shared_libs</code></td>
<td><em>VNDK-SP</em></td>
</tr>
</tbody></table>
<p>下表列出了供应商进程的命名空间配置（摘自 <code>ld.config.vndk_lite.txt</code> 中的 <code>[vendor]</code> 部分）：</p>
<table>
<tbody><tr>
<th>命名空间</th>
<th>属性</th>
<th>值</th>
</tr>
<tr>
<td rowspan="2"><code>default</code></td>
<td><code>search.paths</code></td>
<td>
<code>/odm/${LIB}</code><br />
<code>/odm/${LIB}/vndk</code><br />
<code>/odm/${LIB}/vndk-sp</code><br />
<code>/vendor/${LIB}</code><br />
<code>/vendor/${LIB}/vndk</code><br />
<code>/vendor/${LIB}/vndk-sp</code><br />
<code>/system/${LIB}/vndk-${VER}</code><br />
<code>/system/${LIB}/vndk-sp-${VER}</code><br />
<code>/system/${LIB}</code>（已弃用）<br />
<code>/product/${LIB}</code>（已弃用）
</td>
</tr>
<tr>
<td><code>isolated</code></td>
<td><code>false</code></td>
</tr>
</tbody></table>
<p>更多详情请见 <code>${android-src}/system/core/rootdir/etc/ld.config.vndk_lite.txt</code>。</p>
<h2 id="document-history">文档历史记录</h2>
<h3 id="changes-p">Android P 变更</h3>
<ul>
<li><p>在 Android P 中，<code>vndk</code> 链接器命名空间已添加到供应商进程，而且 VNDK 共享库已与默认链接器命名空间隔离开。</p></li>
<li><p>将 <code>PRODUCT_FULL_TREBLE</code> 替换为更具体的 <code>PRODUCT_TREBLE_LINKER_NAMESPACES</code>。</p></li>
<li>
<p>Android P 更改了以下动态链接器配置文件的名称：</p>
<table>
<tbody><tr>
<th>Android 8.x</th>
<th>Android P</th>
<th>说明</th>
</tr>
<tr>
<td>ld.config.txt.in</td>
<td>ld.config.txt</td>
<td>对于具有运行时链接器命名空间隔离的设备</td>
</tr>
<tr>
<td>ld.config.txt</td>
<td>ld.config.vndk_lite.txt</td>
<td>对于具有 VNDK-SP 链接器命名空间隔离的设备</td>
</tr>
<tr>
<td>ld.config.legacy.txt</td>
<td>ld.config.legacy.txt</td>
<td>对于搭载 Android 7.x 及更早版本的旧版设备</td>
</tr>
</tbody></table>
</li>
<li><p>移除 <code>android.hardware.graphics.allocator@2.0.so</code>。</p></li>
<li><p>添加了 <code>product</code> 和 <code>odm</code> 分区。</p></li>
</ul>
</body></html>
|
