<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>XCFramework on Last Stand</title><link>https://amatsuzero.github.io/LastStand/tags/xcframework/</link><description>Recent content in XCFramework on Last Stand</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Tue, 22 Sep 2026 14:12:53 +0800</lastBuildDate><atom:link href="https://amatsuzero.github.io/LastStand/tags/xcframework/index.xml" rel="self" type="application/rss+xml"/><item><title>GitLab 上 KMP 二进制的发布链路与踩坑</title><link>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-kmp-build/</link><pubDate>Tue, 22 Sep 2026 14:12:53 +0800</pubDate><guid>https://amatsuzero.github.io/LastStand/posts/ugreen-notes/gitlab-kmp-build/</guid><description>&lt;h2 id="背景"&gt;背景&lt;/h2&gt;
&lt;p&gt;把 Kotlin Multiplatform 共享库以 XCFramework 形式发给 iOS 侧使用时，发布链路并不只是「编出来传上去」。它涉及 XCFramework 构建、二进制归档、私有 CocoaPods Specs 仓库、GitLab 包 registry，以及一连串的权限与凭据隔离问题。这里把一次完整发布踩过的坑整理成可复用的清单。&lt;/p&gt;
&lt;h2 id="推荐发布链路"&gt;推荐发布链路&lt;/h2&gt;
&lt;pre class="mermaid"&gt;
flowchart LR
A[构建 XCFramework] --&gt; B[打包 ZIP + SHA256]
B --&gt; C[生成二进制 Podspec]
C --&gt; D[上传 GitLab Generic Package]
D --&gt; E[匿名下载并校验 ZIP/SHA]
E --&gt; F[pod spec lint]
F --&gt; G[push Podspec 到私有 Specs Git]
G --&gt; H[重新 clone / readback]
H --&gt; I[干净 Podfile 执行 pod install]
&lt;/pre&gt;
&lt;h2 id="名词解释"&gt;名词解释&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;XCFramework&lt;/strong&gt;：Apple 的跨平台 / 多架构二进制分发格式，可同时携带真机与模拟器 slice。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Podspec&lt;/strong&gt;：CocoaPods 的依赖描述文件，声明版本、源码 / 二进制地址与校验和。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Specs 仓库&lt;/strong&gt;：存放 Podspec 的私有 Git 仓库，相当于私有 CocoaPods 源。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Generic Package Registry&lt;/strong&gt;：GitLab 提供的通用二进制包仓库，用来托管 ZIP 等任意产物。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Project Access Token&lt;/strong&gt;：GitLab 的项目级访问令牌，区别于个人令牌，可限定角色与权限范围。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="1-版本必须全链路一致"&gt;1. 版本必须全链路一致&lt;/h2&gt;
&lt;p&gt;以下字段必须保持一致：Git tag、VERSION_NAME、Podspec 的 version、Package Registry 路径、ZIP 文件名、checksum sidecar 文件名，以及 Specs 路径（如 UgreenHomeShared/1.7.0.4/UgreenHomeShared.podspec）。&lt;/p&gt;</description></item></channel></rss>