[feat] add native Android controller

2026-10-16 17:10:20 +08:00 · 2026-10-01 23:17:47 +08:00
parent 149d20cbd1
commit f08194f686
73 changed files with 5466 additions and 15 deletions
@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""Check the shipped native ABI, ELF load alignment and APK zip alignment."""
+from pathlib import Path
+import hashlib
+import json
+import struct
+import sys
+import zipfile
+
+
+def verify(path):
+    with zipfile.ZipFile(path) as archive, open(path, 'rb') as raw:
+        libraries = [i for i in archive.infolist() if i.filename.endswith('.so')]
+        if [i.filename for i in libraries] != ['lib/arm64-v8a/libcrossdesk_android.so']:
+            raise ValueError('APK must contain exactly the arm64 native controller library')
+        library = libraries[0]
+        data = archive.read(library)
+        if data[:6] != b'\x7fELF\x02\x01' or struct.unpack_from('<H', data, 18)[0] != 183:
+            raise ValueError('Native library is not little-endian ELF64 AArch64')
+        offset = struct.unpack_from('<Q', data, 32)[0]
+        size, count = struct.unpack_from('<HH', data, 54)
+        segments = [struct.unpack_from('<IIQQQQQQ', data, offset + i * size) for i in range(count)]
+        loads = [s for s in segments if s[0] == 1]
+        if not loads or any(s[7] < 16384 or (s[2] - s[3]) % 16384 for s in loads):
+            raise ValueError('ELF PT_LOAD segments must be aligned to at least 16 KB')
+        if library.compress_type != zipfile.ZIP_STORED:
+            raise ValueError('Native library must be stored uncompressed')
+        raw.seek(library.header_offset + 26)
+        name, extra = struct.unpack('<HH', raw.read(4))
+        if (library.header_offset + 30 + name + extra) % 16384:
+            raise ValueError('APK native library entry is not 16 KB aligned')
+        if 'assets/THIRD_PARTY_NOTICES.txt' not in archive.namelist():
+            raise ValueError('Missing third-party notices')
+        catalog = json.loads(archive.read('assets/ThirdPartyLicenses.json'))
+        source = json.loads(archive.read('assets/SourceMetadata.json'))
+        components = catalog['components']
+        ids = [item['id'] for item in components]
+        if catalog['schemaVersion'] != 1 or len(ids) != len(set(ids)) or not {
+                'crossdesk', 'minirtc', 'openfec', 'openh264', 'libiconv', 'android-ndk', 'svt-av1'}.issubset(ids):
+            raise ValueError('Incomplete About catalog')
+        for component in components:
+            if not component['documents']:
+                raise ValueError('Missing component documents')
+            for document in component['documents']:
+                text = archive.read('assets/'+document['asset'])
+                if not text or hashlib.sha256(text).hexdigest() != document['sha256']:
+                    raise ValueError('Incomplete license document: '+document['asset'])
+            for document in component.get('buildDocuments', []):
+                if not archive.read('assets/'+document['asset']):
+                    raise ValueError('Missing build document')
+        if source['schemaVersion'] != 1 or len(source['revision']) != 40:
+            raise ValueError('Missing source revision')
+        for document in source['buildDocuments']:
+            if not archive.read('assets/'+document['asset']):
+                raise ValueError('Missing source build instructions')
+    print(f'PASS: {Path(path).name}: arm64, 16 KB ELF/ZIP alignment, notices, About catalog and documents')
+
+
+if __name__ == '__main__':
+    verify(sys.argv[1])