飘逸峰的博客

Spring--Java程序员的春天

发表于 分类于 ， ， 置顶 精品
阅读次数： 0 本文字数： 2k 阅读时长 ≈ 7 分钟

摘要

  • Trusted Publishing 的配置、Workflow 权限和 provenance 见 使用 GitHub Actions 和 OIDC 安全发布 npm 包。配好之后，每次发布仍然要在本地升版本、打 vX.Y.Z 标签、推上去，再等 GitHub Actions 跑完 npm publish。
  • npm-publish-oidc 把本地这一段收成项目根目录里的一条命令。它检查项目、按需提升版本、推送提交和标签。npm publish 由该项目的 GitHub Actions 通过 npm Trusted Publishing 完成。
  • 当前工作目录就是项目根目录。脚本不会切到自己所在的目录。
阅读全文 »

发表于 分类于 置顶 精品
阅读次数： 0 本文字数： 2k 阅读时长 ≈ 7 分钟

摘要

  • 手写 Formula、创建 Tap 的过程见 brew -- 创建自己的 Formula。版本发上去之后，每次还要自己算下一个版本、推 tag、下载 GitHub 源码包、改 url / sha256，再把 formula 提交进 Tap。
  • brew-publish-formula 把这几步收成项目根目录里的一条命令。它读当前仓库的配置、formula 和 git 信息，算出新版本，推送 tag，更新 formula，再把文件同步到本地 Tap。
  • 正确的 sha256 要等 tag 到达 GitHub 之后才能算。脚本写进项目里的 .formula，再复制到 Tap 并在 Tap 仓库提交。Homebrew 读的是 Tap 里的那份。.formula 不进项目仓库。
  • brew 本身的安装和日常命令见 MacOS软件包管理器--brew。
阅读全文 »

发表于 更新于 分类于 置顶 精品
阅读次数： 0 本文字数： 10k 阅读时长 ≈ 37 分钟

摘要

阅读全文 »

发表于 更新于 分类于 置顶 精品
阅读次数： 0 本文字数： 4.2k 阅读时长 ≈ 15 分钟

摘要

  • Portfile 是 MacPorts 的安装脚本，对应 Homebrew 的 formula。官方 ports 树里没有的软件，可以放在本机的一个目录里，在 sources.conf 登记之后，用同样的 port install 安装。
  • 本地目录要写成 file://，放在带 [default] 的那一行前面，并加上 [nosync]。Portfile 放在 分类/名字/Portfile。改完在仓库根目录执行 portindex。
  • 下面用 brew -- 创建自己的 Formula 里的 color_echo 1.0.0 作例子。源码是 GitHub tag v1.0.0 的归档，命令文件在 bin/color_echo。安装和日常命令见 MacOS软件包管理器--MacPorts。没有 brew tap 这种命令，个人仓库是一份 Git 上的 ports 树，别人克隆后写进自己的 sources.conf。
  • 本机 MacPorts 是 2.12.7。sources.conf 里的默认行是 ports.tar.gz，不是指南旧示例里的 ports.tar。
阅读全文 »

发表于 更新于 分类于 置顶 精品
阅读次数： 0 本文字数： 2.3k 阅读时长 ≈ 8 分钟

摘要

  • brew install、brew upgrade 下载很慢或中途断开时，可以自己把同一个安装包下完，放到 Homebrew 这次要读的缓存文件上，再重新执行原来的命令。下面用本机升级 gh 2.102.0 作例子。Homebrew 7.0.8，缓存目录是 ~/Library/Caches/Homebrew。这次 GitHub 上的源码包下到一半就断了：curl: (18) Transferred a partial file。
  • 可以自己把同一个压缩包下完，再放到 Homebrew 这次要读的缓存文件上。放进去的必须是 formula 里那个 URL 的文件，SHA-256 也要一致。文件名以 brew --cache --build-from-source gh 的输出为准，不能自己编哈希，也不能拷进 $(brew --cellar)/gh。
  • gh 2.102.0 在当前 API 里没有 bottle，所以这次下的就是源码包 https://github.com/cli/cli/archive/refs/tags/v2.102.0.tar.gz，校验和是 08bf0ef8b4409893889175e0f5279d30d6edd96465816042c0d7c72eac598158。本机缓存文件名是 downloads/838ae966d01d820dbc2c41ab1f82d72064fe030ca19254fb2ff3aa993768b18d--cli-2.102.0.tar.gz。前半段是这条 URL 的 SHA-256，后半段来自下载响应里的文件名。
  • 校验通过后再执行原来的 brew upgrade gh 或 brew install gh。Homebrew 会接着做自己的校验和编译。缓存和 Cellar 的差别见 MacOS软件包管理器--brew。
  • Cask 用同一套缓存目录。路径改成 brew --cache --cask <token>，放进去的是这个 cask 的 url 指向的那个文件。本机 Firefox 是 dmg，codex 是 tar.gz，claude-code 没有后缀。例子在文末。
阅读全文 »

发表于 分类于 置顶 精品
阅读次数： 0 本文字数： 2k 阅读时长 ≈ 7 分钟

摘要

  • 本机环境 15.8.1-x86_64。
  • Homebrew 7.0.8 不再为 Intel Mac 提供 cmake 的 bottle，brew upgrade cmake 会从源码执行 ./bootstrap。cmake 4.4.4 停在 Cannot find a C++ compiler that supports both C++11。
  • 失败点在 C++ 头文件的搜索路径，不在某一个依赖 cmake 的软件包。直接升级或安装 cmake，以及任何要在本机编译 cmake 的 formula，都会停在同一处。这次是升级 wget 时把它作为依赖编出来的。
  • /usr/bin/clang++ 是 Apple Clang 17.0.0，clang++ --version 正常，CC、CXX、CXXFLAGS 都没有设置。用一段 C++11 程序编译，报错是 fatal error: 'iostream' file not found。
  • iostream 在各个 SDK 里都有，例如 /Library/Developer/CommandLineTools/SDKs/MacOSX26.2.sdk/usr/include/c++/v1/iostream。编译器实际搜索的是 /Library/Developer/CommandLineTools/usr/include/c++/v1。这条路径按编译器自己的位置计算：InstalledDir 是 CommandLineTools/usr/bin，libc++ 头文件放在它的上一级 usr/include/c++/v1。这个目录还在，里面没有 iostream。目录一旦存在，驱动就只用它，不再把 SDK 里的那份加入搜索路径。
  • 把这个目录改名为 c++.backup 之后，同一段 C++11 程序可以编译并输出 123，再执行 brew upgrade cmake。
  • 日志里的 Intel x86_64、Tier 3 警告说明这次为什么要本地编译。Homebrew 在 Intel 上的支持变化见 MacOS软件包管理器--brew 文末「从 4.5 到 7.0」。
阅读全文 »

发表于 更新于 分类于 置顶 精品
阅读次数： 0 本文字数： 4k 阅读时长 ≈ 14 分钟

摘要

  • MacPorts 是 macOS 上的软件包管理器，用来安装命令行工具和库，例如 git、wget、nginx。角色和 MacOS软件包管理器--brew 相同，默认目录是 /opt/local，可以和 Homebrew 装在同一台机器上。
  • 安装脚本叫 Portfile，对应 Homebrew 的 formula。可选功能做成变体，安装时用 + / - 选择。日常命令是 port，改动系统的操作要加 sudo。自己编写 Portfile 并在本机安装，见 MacPorts -- 创建自己的 Port。
  • Homebrew 计划在 2027 年 9 月或更晚停止在 Intel Mac 上运行，官方建议改用 MacPorts。已经用 brew 装好的软件不会自动搬过来，要在 MacPorts 里重新装。
  • 本文命令对照 MacPorts Guide，安装包版本以指南页上的 2.12.6 为例。本机是 MacOS Intel Sequoia 15.7.9，安装包选带 15-Sequoia 的 pkg。
阅读全文 »

发表于 更新于 分类于 置顶 精品
阅读次数： 0 本文字数： 6.5k 阅读时长 ≈ 24 分钟

摘要

  • brew 用 formula 从源码（或 bottle）安装软件，用 cask 安装已经打好的成品。成品常见是 .app / .pkg，也可以只是一个命令行二进制，不一定非要是 GUI。

  • 本文介绍如何在 macos 下创建自己的 Cask，和 brew -- 创建自己的 Formula 是一对：那篇讲 Formula，这篇讲 Cask。

  • 本文基于 MacOS 15.x，brew 版本为 Homebrew 7.0.4。

  • 关于 brew 的安装及使用可以参考 MacOS软件包管理器--brew

阅读全文 »

发表于 分类于 ， 置顶 精品
阅读次数： 0 本文字数： 2k 阅读时长 ≈ 7 分钟

摘要

阅读全文 »

发表于 分类于 ， 置顶 精品
阅读次数： 0 本文字数： 1.9k 阅读时长 ≈ 7 分钟

摘要

  • MySQL 从 5.7.8 起提供原生 JSON 类型：写入时自动校验、内部二进制存储，查询可用路径表达式与一组 JSON_* 函数
  • 本文按日常用法整理：建表写入、路径取值（-> / ->>）、增删改键、生成列索引、多值索引，以及常见坑
  • 适合日志 / 埋点 / 半结构化扩展字段；强一致业务主表仍建议用普通列
  • Shell 侧批量导入见 MySQL Shell（mysqlsh）使用手册：常用功能速查 的 util.importJson；官方文档：The JSON Data Type、JSON Functions
阅读全文 »
0%