| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 1 | // | 
|  | 2 | // Copyright (C) 2019 The Android Open Source Project | 
|  | 3 | // | 
|  | 4 | // Licensed under the Apache License, Version 2.0 (the "License"); | 
|  | 5 | // you may not use this file except in compliance with the License. | 
|  | 6 | // You may obtain a copy of the License at | 
|  | 7 | // | 
|  | 8 | //      http://www.apache.org/licenses/LICENSE-2.0 | 
|  | 9 | // | 
|  | 10 | // Unless required by applicable law or agreed to in writing, software | 
|  | 11 | // distributed under the License is distributed on an "AS IS" BASIS, | 
|  | 12 | // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 
|  | 13 | // See the License for the specific language governing permissions and | 
|  | 14 | // limitations under the License. | 
|  | 15 | // | 
|  | 16 |  | 
| Bob Badour | 97e6be2 | 2021-02-12 14:45:04 -0800 | [diff] [blame] | 17 | package { | 
|  | 18 | default_applicable_licenses: ["Android-Apache-2.0"], | 
|  | 19 | } | 
|  | 20 |  | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 21 | java_defaults { | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 22 | name: "TetheringApiLevel", | 
| Anton Hansson | bbe4af1 | 2020-03-18 14:15:42 +0000 | [diff] [blame] | 23 | sdk_version: "module_current", | 
| Nikita Ioffe | 583e35a | 2020-10-31 22:41:41 +0000 | [diff] [blame] | 24 | min_sdk_version: "30", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 25 | } | 
|  | 26 |  | 
|  | 27 | java_defaults { | 
| Harshit Mahajan | e210c27 | 2022-08-23 19:27:39 +0000 | [diff] [blame] | 28 | name: "TetheringReleaseTargetSdk", | 
|  | 29 | target_sdk_version: "33", | 
|  | 30 | } | 
|  | 31 |  | 
|  | 32 | java_defaults { | 
| Remi NGUYEN VAN | 37dc1e2 | 2022-08-04 11:52:54 +0900 | [diff] [blame] | 33 | name: "TetheringExternalLibs", | 
|  | 34 | // Libraries not including Tethering's own framework-tethering (different flavors of that one | 
|  | 35 | // are needed depending on the build rule) | 
|  | 36 | libs: [ | 
| Igor Chernyshev | 9dac660 | 2022-12-13 19:28:32 -0800 | [diff] [blame] | 37 | "connectivity-internal-api-util", | 
| Hassan Ali | c4f63fa | 2022-11-17 16:13:48 +0000 | [diff] [blame] | 38 | "framework-configinfrastructure", | 
| Remi NGUYEN VAN | 37dc1e2 | 2022-08-04 11:52:54 +0900 | [diff] [blame] | 39 | "framework-connectivity.stubs.module_lib", | 
|  | 40 | "framework-connectivity-t.stubs.module_lib", | 
|  | 41 | "framework-statsd.stubs.module_lib", | 
|  | 42 | "framework-wifi", | 
|  | 43 | "framework-bluetooth", | 
|  | 44 | "unsupportedappusage", | 
|  | 45 | ], | 
|  | 46 | defaults_visibility: ["//visibility:private"], | 
|  | 47 | } | 
|  | 48 |  | 
|  | 49 | java_defaults { | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 50 | name: "TetheringAndroidLibraryDefaults", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 51 | srcs: [ | 
| Hungming Chen | dd55b91 | 2020-12-26 17:13:22 +0800 | [diff] [blame] | 52 | "apishim/**/*.java", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 53 | "src/**/*.java", | 
| Aaron Huang | b401e58 | 2021-01-22 18:35:00 +0800 | [diff] [blame] | 54 | ":framework-connectivity-shared-srcs", | 
| markchien | 43e97e0 | 2019-09-03 15:58:06 +0800 | [diff] [blame] | 55 | ":services-tethering-shared-srcs", | 
| Wayne Ma | 7ecded8 | 2022-03-10 16:19:24 +0800 | [diff] [blame] | 56 | ":statslog-tethering-java-gen", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 57 | ], | 
|  | 58 | static_libs: [ | 
|  | 59 | "androidx.annotation_annotation", | 
| Hungming Chen | 01f2550 | 2022-06-28 22:47:00 +0800 | [diff] [blame] | 60 | "connectivity-net-module-utils-bpf", | 
| Hungming Chen | dd55b91 | 2020-12-26 17:13:22 +0800 | [diff] [blame] | 61 | "modules-utils-build", | 
| William Escande | ea9e22e | 2021-08-19 12:26:52 +0200 | [diff] [blame] | 62 | "modules-utils-statemachine", | 
| Jeongik Cha | d05f990 | 2021-01-26 22:35:02 +0900 | [diff] [blame] | 63 | "networkstack-client", | 
| KH Shi | 3d5e65c | 2022-12-26 17:39:54 +0800 | [diff] [blame] | 64 | // AIDL tetheroffload implementation | 
|  | 65 | "android.hardware.tetheroffload-V1-java", | 
|  | 66 | // HIDL tetheroffload implementation | 
| markchien | 547e168 | 2020-02-05 12:42:25 +0800 | [diff] [blame] | 67 | "android.hardware.tetheroffload.config-V1.0-java", | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 68 | "android.hardware.tetheroffload.control-V1.0-java", | 
| junyulai | 177dc86 | 2021-03-10 15:26:50 +0800 | [diff] [blame] | 69 | "android.hardware.tetheroffload.control-V1.1-java", | 
| KH Shi | 3d5e65c | 2022-12-26 17:39:54 +0800 | [diff] [blame] | 70 | "android.hidl.manager-V1.2-java", | 
| markchien | 75fc6ab | 2020-01-14 17:28:47 +0800 | [diff] [blame] | 71 | "net-utils-framework-common", | 
| Chalard Jean | bdcca92 | 2020-06-26 00:19:33 +0900 | [diff] [blame] | 72 | "net-utils-device-common", | 
| markchien | 782a568 | 2021-11-10 01:11:33 +0800 | [diff] [blame] | 73 | "net-utils-device-common-bpf", | 
| Xiao Ma | c81c066 | 2022-06-17 14:58:03 +0900 | [diff] [blame] | 74 | "net-utils-device-common-ip", | 
| Xiao Ma | 09c0727 | 2021-07-01 14:00:34 +0000 | [diff] [blame] | 75 | "net-utils-device-common-netlink", | 
| lucaslin | ee661df | 2020-12-28 16:44:49 +0800 | [diff] [blame] | 76 | "netd-client", | 
| Wayne Ma | 71d6639 | 2022-03-03 10:15:09 +0800 | [diff] [blame] | 77 | "tetheringstatsprotos", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 78 | ], | 
| Remi NGUYEN VAN | 37dc1e2 | 2022-08-04 11:52:54 +0900 | [diff] [blame] | 79 | defaults: ["TetheringExternalLibs"], | 
| markchien | 9d35382 | 2019-12-16 20:15:20 +0800 | [diff] [blame] | 80 | libs: [ | 
| Paul Duffin | 2dae272 | 2020-05-13 12:28:49 +0100 | [diff] [blame] | 81 | "framework-tethering.impl", | 
| markchien | 9d35382 | 2019-12-16 20:15:20 +0800 | [diff] [blame] | 82 | ], | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 83 | manifest: "AndroidManifestBase.xml", | 
| Motomu Utsumi | ac7c572 | 2023-11-15 11:51:42 +0900 | [diff] [blame] | 84 | lint: { | 
|  | 85 | strict_updatability_linting: true, | 
|  | 86 | error_checks: ["NewApi"], | 
|  | 87 | }, | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 88 | } | 
|  | 89 |  | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 90 | // build tethering static library, used to compile both variants of the tethering. | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 91 | android_library { | 
|  | 92 | name: "TetheringApiCurrentLib", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 93 | defaults: [ | 
| Remi NGUYEN VAN | f826bce | 2022-01-26 17:43:53 +0900 | [diff] [blame] | 94 | "ConnectivityNextEnableDefaults", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 95 | "TetheringAndroidLibraryDefaults", | 
| Harshit Mahajan | e210c27 | 2022-08-23 19:27:39 +0000 | [diff] [blame] | 96 | "TetheringApiLevel", | 
|  | 97 | "TetheringReleaseTargetSdk" | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 98 | ], | 
|  | 99 | static_libs: [ | 
|  | 100 | "NetworkStackApiCurrentShims", | 
| Junyu Lai | 626045a | 2023-08-28 18:49:44 +0800 | [diff] [blame] | 101 | "net-utils-device-common-struct", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 102 | ], | 
|  | 103 | apex_available: ["com.android.tethering"], | 
| Chiachang Wang | 3bc5276 | 2021-11-25 14:17:57 +0800 | [diff] [blame] | 104 | lint: { strict_updatability_linting: true }, | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 105 | } | 
|  | 106 |  | 
|  | 107 | android_library { | 
|  | 108 | name: "TetheringApiStableLib", | 
|  | 109 | defaults: [ | 
|  | 110 | "TetheringAndroidLibraryDefaults", | 
| Harshit Mahajan | e210c27 | 2022-08-23 19:27:39 +0000 | [diff] [blame] | 111 | "TetheringApiLevel", | 
|  | 112 | "TetheringReleaseTargetSdk" | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 113 | ], | 
|  | 114 | static_libs: [ | 
|  | 115 | "NetworkStackApiStableShims", | 
| Junyu Lai | 626045a | 2023-08-28 18:49:44 +0800 | [diff] [blame] | 116 | "net-utils-device-common-struct", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 117 | ], | 
|  | 118 | apex_available: ["com.android.tethering"], | 
| Chiachang Wang | 3bc5276 | 2021-11-25 14:17:57 +0800 | [diff] [blame] | 119 | lint: { strict_updatability_linting: true }, | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 120 | } | 
|  | 121 |  | 
| markchien | 810aa68 | 2019-10-23 16:27:52 +0800 | [diff] [blame] | 122 | // Due to b/143733063, APK can't access a jni lib that is in APEX (but not in the APK). | 
|  | 123 | cc_library { | 
| markchien | f967b11 | 2021-11-09 16:56:23 +0800 | [diff] [blame] | 124 | name: "libcom_android_networkstack_tethering_util_jni", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 125 | sdk_version: "30", | 
| Jooyung Han | 8182d8b | 2020-04-29 02:43:30 +0900 | [diff] [blame] | 126 | apex_available: [ | 
| Jooyung Han | 8182d8b | 2020-04-29 02:43:30 +0900 | [diff] [blame] | 127 | "com.android.tethering", | 
|  | 128 | ], | 
| Nikita Ioffe | 583e35a | 2020-10-31 22:41:41 +0000 | [diff] [blame] | 129 | min_sdk_version: "30", | 
| Lorenzo Colitti | 734b14e | 2021-02-05 23:56:09 +0900 | [diff] [blame] | 130 | header_libs: [ | 
| Ken Chen | bb57fa9 | 2021-10-22 00:49:13 +0800 | [diff] [blame] | 131 | "bpf_connectivity_headers", | 
| Lorenzo Colitti | 734b14e | 2021-02-05 23:56:09 +0900 | [diff] [blame] | 132 | ], | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 133 | srcs: [ | 
| markchien | 7052688 | 2020-11-12 00:17:15 +0800 | [diff] [blame] | 134 | "jni/*.cpp", | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 135 | ], | 
|  | 136 | shared_libs: [ | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 137 | "liblog", | 
| markchien | 547e168 | 2020-02-05 12:42:25 +0800 | [diff] [blame] | 138 | "libnativehelper_compat_libc++", | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 139 | ], | 
| Orion Hodson | e5bd0db | 2020-12-08 09:57:42 +0000 | [diff] [blame] | 140 | static_libs: [ | 
| markchien | 782a568 | 2021-11-10 01:11:33 +0800 | [diff] [blame] | 141 | "libnet_utils_device_common_bpfjni", | 
| Orion Hodson | e5bd0db | 2020-12-08 09:57:42 +0000 | [diff] [blame] | 142 | "libnetjniutils", | 
|  | 143 | ], | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 144 |  | 
| markchien | 547e168 | 2020-02-05 12:42:25 +0800 | [diff] [blame] | 145 | // We cannot use plain "libc++" here to link libc++ dynamically because it results in: | 
|  | 146 | //   java.lang.UnsatisfiedLinkError: dlopen failed: library "libc++_shared.so" not found | 
|  | 147 | // even if "libc++" is added into jni_libs below. Adding "libc++_shared" into jni_libs doesn't | 
|  | 148 | // build because soong complains of: | 
|  | 149 | //   module Tethering missing dependencies: libc++_shared | 
|  | 150 | // | 
|  | 151 | // So, link libc++ statically. This means that we also need to ensure that all the C++ libraries | 
|  | 152 | // we depend on do not dynamically link libc++. This is currently the case, because liblog is | 
|  | 153 | // C-only and libnativehelper_compat_libc also uses stl: "c++_static". | 
|  | 154 | stl: "c++_static", | 
|  | 155 |  | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 156 | cflags: [ | 
|  | 157 | "-Wall", | 
|  | 158 | "-Werror", | 
|  | 159 | "-Wno-unused-parameter", | 
|  | 160 | "-Wthread-safety", | 
|  | 161 | ], | 
| markchien | 810aa68 | 2019-10-23 16:27:52 +0800 | [diff] [blame] | 162 |  | 
| Yi Kong | 20a996e | 2022-06-22 03:41:56 +0800 | [diff] [blame] | 163 | ldflags: ["-Wl,--exclude-libs=ALL,--error-limit=0"], | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 164 | } | 
|  | 165 |  | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 166 | // Common defaults for compiling the actual APK. | 
|  | 167 | java_defaults { | 
|  | 168 | name: "TetheringAppDefaults", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 169 | privileged: true, | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 170 | jni_libs: [ | 
| markchien | f967b11 | 2021-11-09 16:56:23 +0800 | [diff] [blame] | 171 | "libcom_android_networkstack_tethering_util_jni", | 
| markchien | 6aa3889 | 2019-09-25 14:33:39 +0800 | [diff] [blame] | 172 | ], | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 173 | resource_dirs: [ | 
|  | 174 | "res", | 
|  | 175 | ], | 
| Remi NGUYEN VAN | 37dc1e2 | 2022-08-04 11:52:54 +0900 | [diff] [blame] | 176 | // Libs are not actually needed to build here since build rules using these defaults are just | 
|  | 177 | // packaging the TetheringApiXLibs in APKs, but they are necessary so that R8 has the right | 
|  | 178 | // references to optimize the code. Without these, there will be missing class warnings and code | 
|  | 179 | // may be wrongly optimized. | 
|  | 180 | // R8 runs after jarjar, so the framework-X libraries need to be the post-jarjar artifacts | 
|  | 181 | // (framework-tethering.impl), if they are not just stubs, so that the name of jarjared | 
|  | 182 | // classes match. | 
|  | 183 | // TODO(b/229727645): ensure R8 fails the build fully if libraries are missing | 
|  | 184 | defaults: ["TetheringExternalLibs"], | 
| markchien | 9d35382 | 2019-12-16 20:15:20 +0800 | [diff] [blame] | 185 | libs: [ | 
| Remi NGUYEN VAN | 37dc1e2 | 2022-08-04 11:52:54 +0900 | [diff] [blame] | 186 | "framework-tethering.impl", | 
| markchien | 9d35382 | 2019-12-16 20:15:20 +0800 | [diff] [blame] | 187 | ], | 
|  | 188 | jarjar_rules: "jarjar-rules.txt", | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 189 | optimize: { | 
|  | 190 | proguard_flags_files: ["proguard.flags"], | 
|  | 191 | }, | 
| Chiachang Wang | 3bc5276 | 2021-11-25 14:17:57 +0800 | [diff] [blame] | 192 | lint: { strict_updatability_linting: true }, | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 193 | } | 
|  | 194 |  | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 195 | // Updatable tethering packaged for finalized API | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 196 | android_app { | 
|  | 197 | name: "Tethering", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 198 | defaults: ["TetheringAppDefaults", "TetheringApiLevel"], | 
|  | 199 | static_libs: ["TetheringApiStableLib"], | 
|  | 200 | certificate: "networkstack", | 
|  | 201 | manifest: "AndroidManifest.xml", | 
|  | 202 | use_embedded_native_libs: true, | 
| Anton Hansson | 1397a10 | 2023-05-25 07:04:33 +0000 | [diff] [blame] | 203 | privapp_allowlist: ":privapp_allowlist_com.android.tethering", | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 204 | apex_available: ["com.android.tethering"], | 
| Chiachang Wang | 3bc5276 | 2021-11-25 14:17:57 +0800 | [diff] [blame] | 205 | lint: { strict_updatability_linting: true }, | 
| markchien | 5a8c806 | 2021-10-27 13:22:27 +0800 | [diff] [blame] | 206 | } | 
|  | 207 |  | 
|  | 208 | android_app { | 
|  | 209 | name: "TetheringNext", | 
| markchien | 598a75b | 2021-11-22 10:36:32 +0800 | [diff] [blame] | 210 | defaults: [ | 
|  | 211 | "TetheringAppDefaults", | 
|  | 212 | "TetheringApiLevel", | 
|  | 213 | "ConnectivityNextEnableDefaults", | 
|  | 214 | ], | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 215 | static_libs: ["TetheringApiCurrentLib"], | 
|  | 216 | certificate: "networkstack", | 
|  | 217 | manifest: "AndroidManifest.xml", | 
|  | 218 | use_embedded_native_libs: true, | 
| Anton Hansson | 1397a10 | 2023-05-25 07:04:33 +0000 | [diff] [blame] | 219 | privapp_allowlist: ":privapp_allowlist_com.android.tethering", | 
| Jiyong Park | 1eb8933 | 2020-01-06 13:30:59 +0900 | [diff] [blame] | 220 | apex_available: ["com.android.tethering"], | 
| Motomu Utsumi | ac7c572 | 2023-11-15 11:51:42 +0900 | [diff] [blame] | 221 | lint: { | 
|  | 222 | strict_updatability_linting: true, | 
|  | 223 | error_checks: ["NewApi"], | 
|  | 224 | }, | 
| markchien | 932da86 | 2019-08-27 10:19:38 +0800 | [diff] [blame] | 225 | } | 
| Hai Zhang | 6d71f10 | 2021-02-14 06:38:22 +0000 | [diff] [blame] | 226 |  | 
|  | 227 | sdk { | 
|  | 228 | name: "tethering-module-sdk", | 
| Paul Duffin | 1514c03 | 2022-07-13 11:18:50 +0000 | [diff] [blame] | 229 | apexes: [ | 
|  | 230 | // Adds exportable dependencies of the APEX to the sdk, | 
|  | 231 | // e.g. *classpath_fragments. | 
|  | 232 | "com.android.tethering", | 
|  | 233 | ], | 
| Spandan Das | b06f9d6 | 2023-04-04 20:48:54 +0000 | [diff] [blame] | 234 | native_shared_libs: [ | 
| Ken Chen | ec0f7ac | 2023-09-08 14:14:55 +0800 | [diff] [blame] | 235 | "libcom.android.tethering.dns_helper", | 
| Spandan Das | b06f9d6 | 2023-04-04 20:48:54 +0000 | [diff] [blame] | 236 | "libnetd_updatable", | 
|  | 237 | ], | 
| Hai Zhang | 6d71f10 | 2021-02-14 06:38:22 +0000 | [diff] [blame] | 238 | } | 
| Wayne Ma | 71d6639 | 2022-03-03 10:15:09 +0800 | [diff] [blame] | 239 |  | 
|  | 240 | java_library_static { | 
|  | 241 | name: "tetheringstatsprotos", | 
|  | 242 | proto: {type: "lite"}, | 
|  | 243 | srcs: [ | 
|  | 244 | "src/com/android/networkstack/tethering/metrics/stats.proto", | 
|  | 245 | ], | 
|  | 246 | static_libs: ["tetheringprotos"], | 
|  | 247 | apex_available: ["com.android.tethering"], | 
|  | 248 | min_sdk_version: "30", | 
|  | 249 | } | 
| Wayne Ma | 7ecded8 | 2022-03-10 16:19:24 +0800 | [diff] [blame] | 250 |  | 
|  | 251 | genrule { | 
|  | 252 | name: "statslog-tethering-java-gen", | 
|  | 253 | tools: ["stats-log-api-gen"], | 
|  | 254 | cmd: "$(location stats-log-api-gen) --java $(out) --module network_tethering" + | 
|  | 255 | " --javaPackage com.android.networkstack.tethering.metrics --javaClass TetheringStatsLog", | 
|  | 256 | out: ["com/android/networkstack/tethering/metrics/TetheringStatsLog.java"], | 
| Yi Kong | 20a996e | 2022-06-22 03:41:56 +0800 | [diff] [blame] | 257 | } |