shsuco

常见编程语言文档及新特性链接

Wed, 07 Feb 2024 14:32:38 GMT

Java

https://www.java.com/

Documentation

https://docs.oracle.com/en/java/javase/index.html

Changes

9-21: https://docs.oracle.com/en/java/javase/21/language/java-language-changes.html

1.8: https://www.oracle.com/java/technologies/javase/8-whats-new.html

1.7: https://www.oracle.com/java/technologies/javase/7u-relnotes.html

Kotlin

https://kotlinlang.org

Documentation

https://kotlinlang.org/docs/home.html

Changes

https://kotlinlang.org/docs/whatsnew1920.html#0

Swift

https://www.swift.org

Documentation

https://www.swift.org/documentation/

Changes

https://www.swift.org/swift-evolution/ https://github.com/apple/swift/blob/main/CHANGELOG.md

Objective-C

Documentation

https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html#//apple_ref/doc/uid/TP40011210

https://developer.apple.com/documentation/technologies

Changes

https://developer.apple.com/library/archive/releasenotes/ObjectiveC/ModernizationObjC/AdoptingModernObjective-C/AdoptingModernObjective-C.html

C

https://en.cppreference.com/w/c

C++

https://en.cppreference.com/w/cpp

Rust

https://www.rust-lang.org

Documentation

https://www.rust-lang.org/learn

Changes

https://github.com/rust-lang/rust/blob/master/RELEASES.md

Go

https://go.dev

Documentation

https://go.dev/doc/

Changes

https://go.dev/doc/devel/release

Scala

https://www.scala-lang.org

Documentation

https://docs.scala-lang.org

Changes

https://docs.scala-lang.org/scala3/new-in-scala3.html

Groovy

https://groovy-lang.org

Documentation

https://groovy-lang.org/documentation.html

Changes

http://groovy-lang.org/releases.html http://groovy-lang.org/changelogs.html

Clojure

https://clojure.org

Haskell

https://www.haskell.org

Documentation

https://www.haskell.org/documentation/

Lisp

Common Lisp

https://common-lisp.net https://lisp-lang.org

Documentation

https://lisp-lang.org/wiki/ https://common-lisp.net/documentation

Racket

https://racket-lang.org

Documentation

https://docs.racket-lang.org

OCaml

https://ocaml.org

Documentation

https://ocaml.org/docs

Changes

https://ocaml.org/releases https://ocaml.org/changelog

Idris

https://www.idris-lang.org

Documentation

https://www.idris-lang.org/pages/documentation.html

Changes

https://www.idris-lang.org/category/news.html

Python

https://www.python.org

Documentation

https://docs.python.org/3/

Changes

https://docs.python.org/3/whatsnew/index.html

Ruby

https://www.ruby-lang.org/en/

Documentation

https://www.ruby-lang.org/en/documentation/

Changes

https://www.ruby-lang.org/en/news/

Lua

https://www.lua.org

Documentation

https://www.lua.org/docs.html

Changes

https://www.lua.org/versions.html

Perl

https://www.perl.org

Documentation

https://www.perl.org/docs.html

Changes

https://dev.perl.org/perl5/news/

C#

https://dotnet.microsoft.com/en-us/languages/csharp

Documentation

https://learn.microsoft.com/zh-cn/dotnet/csharp/

Changes

https://learn.microsoft.com/zh-cn/dotnet/csharp/whats-new/

F#

https://fsharp.org

Documentation

https://fsharp.org/docs/

Zig

https://ziglang.org

Documentation

https://ziglang.org/documentation/

Changes

https://ziglang.org/download/release-notes.html

JavaScript

https://developer.mozilla.org/en-US/docs/Web/JavaScript https://developer.mozilla.org/en-US/docs/Glossary/ECMAScript

TypeScript

https://www.typescriptlang.org

Documentation

https://www.typescriptlang.org/docs/

Changes

https://www.typescriptlang.org/docs/handbook/release-notes/

Dart

https://dart.dev

Documentation

https://dart.dev/guides

Changes

https://dart.dev/guides/whats-new

Reason

https://reasonml.github.io

Documentation

https://reasonml.github.io/docs/en/what-and-why

Flow

https://flow.org

Documentation

https://flow.org/en/docs/

CoffeeScript

https://coffeescript.org

ClojureScript

https://clojurescript.org

Erlang

https://www.erlang.org

Documentation

https://www.erlang.org/docs

Changes

https://www.erlang.org/news

Vala

https://vala.dev

Documentation

https://wiki.gnome.org/Projects/Vala/Documentation

命令行时间戳与时间转换

Wed, 18 Oct 2023 10:38:03 GMT

Linux

date -d @<timestamp>

macOS / FreeBSD

date -r <timestamp>

PowerShell

[datetime]::UnixEpoch.AddSeconds(<timestamp>)

Zsh

strftime '%Y-%m-%d %H:%M:%S' <timestamp>

Python

python3 -c "import sys, time; print(time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(int(sys.argv[1]))))" <timestamp>

Perl

perl -MPOSIX -le 'print strftime "%Y-%m-%d %H:%M:%S", localtime($ARGV[0])' <timestamp>

Ruby

ruby -e 'puts Time.at(ARGV[0].to_i).strftime("%Y-%m-%d %H:%M:%S")' <timestamp>

Groovy

groovy -e "println new Date(args[0] as long).format('yyyy-MM-dd HH:mm:ss')" <timestamp>

Node

node -e "console.log(new Date(parseInt(process.argv[1])).toLocaleString())" <timestamp>

存在类型 (existential type)

Thu, 06 Jul 2023 11:29:27 GMT

存在类型(existential type), 表示某个类型存在, 设Trait A, 则some A表示存在某个类型符合A特征; 与存在类型相对应的为任意类型, any A表示负责A特征的任意类型.

设B <: A, C <: A, 则List[some A]可以是List[B]或List[C], List中元素皆为同一类型; 与之对应, List[any A]则表示该List可以存储B或C类型, List中元素不需要为同一类型.

通常, 存在类型可以编译期确定, 而任意类型需要运行期确定, 所以存在类型可以静态派发, 任意类型一般需要动态派发, 因此使用存在类型代替任意类型可以提高效率.

Rust存在类型

设有Trait A:

trait A {...}

Rust以impl A表示存在类型:

fn foo(a: impl A) {...}

fn bar(a: Vec<impl A>) {...}

这等价于

fn foo<T: A>(a: T) {...}

fn bar<T: A>(a: Vec<T>) {...}

Rust以dyn A表示任意类型:

fn foo(a: &dyn A) {...}

fn bar(a: Vec<&dyn A>) {...}

或

fn foo(a: Box<dyn A>) {...}

fn bar(a: Vec<Box<dyn A>>) {...}

由于dyn A的大小编译期未知, 所以需要使用引用, 或者使用指针例如Box.

Swift存在类型(不透明类型)

设有Protocol A:

protocol A {...}

Swift以不透明类型表示存在类型, 与Rust非常相似:

func foo(a: some A) {...}

func bar(a: Array<some A>) {...}

类似的, 这也等价于

func foo<T: A>(a: T) {...}

func bar<T: A>(a: Array<T>) {...}

Swift以any A表示任意类型:

func foo(a: any A) {...}

func bar(a: Array<any A>) {...}

C++存在类型

C++中可以使用模板表示存在类型:

template<typename T>
auto foo(T) -> void {...}

template<typename T>
auto bar(std::span<T>) -> void {...}

也可以加入concept约束

template<typename T>
concept A = requires(T a) {...};

template<A T>
auto foo(T) -> void {...}

template<A T>
auto bar(std::span<T>) -> void {...}

C++中任意类型和存在类型无法统一, 因为模板和concept只能用于静态约束, 任意类型需要动态约束, 可以用继承:

class A {...};

auto foo(A&) -> void {...}  // 可以传入任意A的子类型

auto bar(std::span<A&>) -> void {...} // span中可以存储任意A的子类型引用

其中引用也可以替换为指针或者智能指针.

参考链接

https://en.wikipedia.org/wiki/Type_system#Existential_types

多态 (polymorphism)

Thu, 06 Jul 2023 09:42:37 GMT

多态 (polymorphism) 指为不同数据类型的实体提供统一的接口, 或使用一个单一的符号来表示多个不同的类型.

子类型多态 (subtyping)

面向对象中经常提到的多态为子类型多态, 如C++的虚函数

class A {
public:
    virtual void f() {}
};

class B : public A { 
public :
    virtual void f() {}
};

int main() {
    B b{};
    A &a = b;
    a.f();
    return 0;
}

一般采用虚函数表来实现, 每个含有虚函数(包括继承得到)的类都会有一个对应的虚函数表, 存储虚函数对应指针, 编译器会为这些类型添加一个指针字段指向对应的虚函数表. 虚函数调用时, 通过该指针找到虚函数表, 再调用目标函数.

需要注意子类型并非与继承强绑定. 设类型A, B, 如果需要用到A的位置皆可由B替代, 则B是A的子类型, 即B <: A. 例如存在隐式转换int -> long, 则 int <: long; 协变情况下 List[B] <: List[A].

特设多态 (Ad hoc)

特设多态即针对同一调用不同类型有不同实现, 例如函数重载:

def add(a: Int, b: Int) = a + b

def add(a: String, b: String) = a ++ b

Rust中的Trait:

trait Add {
    fn add(self, rhs: Self) -> Self;
}

struct A;
struct B;

impl Add for A {...}
impl Add for B {...}

fn main {
    let a = A;
    let b = B;
    a.add(a);
    b.add(b);
}

此外, C++模板特化, C++ concept, Go interface, Swift protocol等也可表现特设多态.

参数多态 (Parametric polymorphism)

参数多态即将类型参数化, 进而做统一处理.

def append[T](a: List[T], b: List[T]) = a ++ b

def add[T: Add](a: T, b: T) = a.add(b)

静态多态与动态多态

静态多态生效于编译期, 例如C++模板, Rust静态Trait, Swift不透明类型, 静态派发的函数重载

动态多态生效于运行时, 例如虚函数, Rust动态Trait, Go interface, 动态派发的函数重载

参考资料

https://zh.wikipedia.org/zh-cn/多态_(计算机科学)

SSH 端口转发

Fri, 26 May 2023 14:38:58 GMT

本地转发

ssh -L [bind_address:]port:host:hostport destination
ssh -L [bind_address:]port:remote_socket destination
ssh -L local_socket:host:hostport destination
ssh -L local_socket:remote_socket destination

将本地(客户端)主机上的给定 TCP 端口或 Unix Socket 转发到远程端的给定主机和端口或 Unix Socket.

例如, 服务器8080端口运行私有服务, 可以将本地8081端口转发给服务器8080端口:

ssh -N -L 8081:localhost:8080 user@host

即可通过访问localhost:8081来访问host:8080, 其中-N参数表示不进入交互式Shell.

假设有一内网服务器仅支持内外访问, 且没有运行ssh服务, 这时可以通过转发到另一台开启ssh服务的内网主机来访问:

ssh -N -L 8081:host1:8080 user@host2

即可通过访问localhost:8081来访问host1:8080, 其中host2为开启ssh服务的另一台主机.

以上命令皆省略了bind address, 默认绑定0.0.0.0, 也就是所有网络接口; 安全起见可以指明bind address明确访问范围:

ssh -N -L localhost:8080:host1:8080 user@host2    // 仅可通过localhost访问
ssh -N -L 192.168.1.1:8080:host1:8080 user@host2  // 监听当前内网ip, 仅可通过内网访问
...

远程转发

ssh -N -R [bind_address:]port:host:hostport destination
ssh -N -R [bind_address:]port:local_socket destination
ssh -N -R remote_socket:host:hostport destination
ssh -N -R remote_socket:local_socket destination
ssh -N -R [bind_address:]port destination

将远程(服务器)主机上的给定 TCP 端口或 Unix Socket 转发到本地.

假设本地8080端口运行私有服务, 将host上的8081端口转发给本地8080:

ssh -R 8081:localhost:8080 user@host

即可通过访问host:8081来访问localhost:8080, 这可以用来实现内网穿透.

类似地, 这里省略了bind address, 所以可以通过所以网络接口访问host该转发, 安全起见应指明bind address.

动态转发

ssh -N -D [bind_address:]port destination

这会启动一个SOCKS代理服务器, 例如

ssh -N -D 1080 user@host

启动SOCKS服务, 监听1080端口, 那么将SOCKS代理指定为localhost:1080, 会将流量转发到host, 由host发出, 例如

curl -x socks5://localhost:1080 https://www.google.com

该请求会被host代理.

Monad 浅析

Sat, 20 May 2023 21:19:41 GMT

在Haskell中, 所有Monad都为Applicative函子, 而所有Applicative函子都为Functor, 即

class Applicative m => Monad m

class Functor f => Applicative f

因此, 要想了解Monad, 首先要了解Functor和Applicative.

Functor, 函子

引例

大多数语言拥有空概念, 表示不存在的值, 例如C中的NULL

#define NULL ((void*)0)

表示空指针, 可以转换为任意指针类型;

在Scala中, null表示空引用, 其类型为Null, 是任意引用类型的子类型, 所以null可以转换为任意引用类型:

val foo: Null = null 
val bar: SomeRefType = null

在Kotlin和Swift等语言中, 使用SomeType?标识可空类型, 例如

val a: Int? = 0

本质上, 可以为空的类型为空与任意类型的和类型, 在Haskell中实现为Maybe类型:

data  Maybe a  =  Nothing | Just a

假设有如下Kotlin定义

data class User(val name: String)

对于其实例user, 可以通过user.name访问name, 即

User -> String  // user.name 中的 "."

对于可空类型User?, 考虑safe call运算符?.,

val name = user?.name  // 从user中取出name, 否则返回null

则实际完成了以下操作:

Maybe User -> Maybe String  // user?.name 中的 "?."

也就是通过使用?.运算符将(User -> String)映射为(Maybe User -> Maybe String).

一般地, 对于任意函数(a -> b)都可以映射得到(Maybe a -> Maybe b), 以fmap表示, 则可以有如下实现:

fmap :: (a -> b) -> Maybe a -> Maybe b
fmap _ Nothing       = Nothing
fmap f (Just a)      = Just (f a)

Functor包含了对这种映射的抽象. 事实上, Maybe也是最简单的Functor.

定义

函子在范畴论中定义如下:

设$$C$$和$$D$$为范畴, 从$$C$$至$$D$$的函子为一映射$$F$$:

将每个对象$$X \in C$$映射至一对象$$F(X) \in D$$上
将每个态射$$f:X\rightarrow Y \in C$$映射至一态射$$F(f):F(X) \rightarrow F(Y) \in D$$上, 使之满足下列条件: 2.1. 对任何对象$$X \in C$$, 恒有$${\displaystyle F(\mathbf {id} _{X})=\mathbf {id} _{F(X)}}$$ 2.2. 对任何态射$$f: X \to Y, ; g: Y \to Z$$, 恒有$$F(g \circ f) = F(g) \circ F(f)$$.

换言之, 函子会保持单位态射与态射的复合. 一个由一范畴映射至其自身的函子称之为“自函子”.

以Maybe为例:

1 即为构造 Just
2 为函数 fmap
2.1 表示不变 fmap id === id
2.2 表示组合 fmap (f . g) === (fmap f) . (fmap g)

在Haskell中, Functor表示为类型类:

class Functor f where
    fmap :: (a -> b) -> f a -> f b

成为Functor需要满足条件2.1与2.2; 这里可以验证Maybe的上述fmap实现满足条件.

Applicative函子

假设有如下Kotlin定义

val f: ((A) -> B)? = null
val a: A? = null

那么将f施用给a会有点麻烦, 可以使用以下表达式:

val g: (A?) -> B? = { a -> a?.let { f?.invoke(it) }  }

完成((A) -> B)?到(A?) -> B?的映射, Applicative函子包含了对这种映射的抽象.

定义

Applicative是Functor和Monad的中间结构, 在Haskell标识为类型类:

class Functor f => Applicative f where
    pure :: a -> f a
    (<*>) :: f (a -> b) -> f a -> f b

pure将值装入Applicative, 对应Maybe即为Just; (<*>)将装入Applicative的函数映射为装入Applicative中的值间的函数, 对应Maybe为Maybe (a -> b) -> Maybe a -> Maybe b

成为Applicative函子需满足以下条件:

pure id <*> v = v                            // 不变
pure (.) <*> u <*> v <*> w = u <*> (v <*> w) // 组合
pure f <*> pure x = pure (f x)               // 同态
u <*> pure y = pure ($ y) <*> u              // 交换

Maybe的Applicative实现:

instance Applicative Maybe where
    pure = Just

    Just f  <*> m       = fmap f m
    Nothing <*> _m      = Nothing

Applicative使函子拥有了将装入函子的函数应用给装入函子的值的能力.

Monad, 单子

引例

假设有如下Kotlin定义

data class User(val name: String?)

那么对于可空类型User?实例user, 调用safe call运算符“user?.name”时, 理论上会得到String??类型, 但是“可以为空的可空类型”理应与可空类型等价, 所以String??自动折叠为String?类型.

在Haskell中用Maybe来表示, 即

(Just a | Nothing) | Nothing === Just a | Nothing

也就是

Maybe (Maybe String) === Maybe String

但事实并非如此, Maybe (Maybe String) 与 Maybe String 是两种不同的类型; Monad则可以进行这种折叠操作, 或者避免出现这种嵌套类型.

定义

Monad在范畴论中定义如下:

$${\displaystyle {\mathcal {C}}}$$表示某范畴, $${\displaystyle {\mathcal {C}}}$$上的单子是函子 $${\displaystyle T:{\mathcal {C}}\to {\mathcal {C}}}$$, 连同两个自然变换, 分别是单位$${\displaystyle \eta :1_{\mathcal {C}}\to T}$$(其中$${\displaystyle 1_{\mathcal {C}}}$$是$${\displaystyle {\mathcal {C}}}$$上的恒等函子) 与乘法$${\displaystyle \mu :T^{2}\to T}$$(其中$${\displaystyle T^{2}}$$是复$${\displaystyle T\circ T}$$, 亦是$${\displaystyle {\mathcal {C}}}$$到$${\displaystyle {\mathcal {C}}}$$的函子), 且要满足下列连贯条件：

$${\displaystyle \mu \circ T\mu =\mu \circ \mu T}$$ (左右皆为 $${\displaystyle T^{3}\to T}$$的自然变换). 此处 $${\displaystyle T\mu }$$与 $${\displaystyle \mu T}$$经水平复合而得.
$${\displaystyle \mu \circ T\eta =\mu \circ \eta T=1_{T}}$$ (两者皆为 $${\displaystyle T\to T}$$的自然变换). 此处 $${\displaystyle 1_{T}}$$表示由函子 $$T$$到自身的恒等自然变换.

在Haskell中, Monad表示为类型类:

class Applicative m => Monad m where
    (>>=)       :: forall a b. m a -> (a -> m b) -> m b
    return      :: a -> m a
    return      = pure

与范畴论定义对应如下:

return构造即为单位$${\displaystyle \eta}$$
(>>=)函数为乘法$${\displaystyle \mu}$$
$${\displaystyle \mu \circ T\mu =\mu \circ \mu T}$$ 表示结合, 即 m >>= (\x -> k x >>= h) === (m >>= k) >>= h
$${\displaystyle \mu \circ T\eta =\mu \circ \eta T=1_{T}}$$ 表示左右单位, 即 m >>= return === m 和 return a >>= k === k a

Maybe的Monad可以如下实现:

instance  Monad Maybe  where
    (Just x) >>= k      = k x
    Nothing  >>= _      = Nothing

回到引例, 我们可以这样对Maybe (Maybe String)进行折叠:

a :: Maybe (Maybe String)
a = Just (Just "")

a' :: Maybe String
a' = a >>= id  // 常简写为join a

或者避免产生Maybe (Maybe String):

user :: Maybe User
user = Just User {name = Just ""}

name' :: Maybe String
name' = user >>= name

Monad是自函子范畴上的幺半群

半群

定义: 集合S和其上的二元运算·:S×S→S。若·满足结合律，即：∀x,y,z∈S，有(x·y)·z=x·(y·z), 则称有序对(S,·)为半群, 运算·称为该半群的乘法. 之所以称为半群, 是因为半群只满足群的部分性质.

在Haskell中, 半群用类型类Semigroup表示:

class Semigroup a where
    (<>) :: a -> a -> a

(<>)为半群的二元运算.

幺半群 (单位半群)

幺半群即含有幺元(单位元)的半群, 即: ∃e∈S，使得∀s∈S, e·s=s·e=s, 则S称为幺半群(独异点).

在Haskell中, 幺半群用Monoid表示:

class Semigroup a => Monoid a where
    mempty :: a

mempty为幺半群的单位元.

幺半群的例子

(Int, *) e = 1

1 * x == x * 1 == × (a * b) * c == a * (b * c)

(Int, +) e = 0

0 + x == x + 0 == x (a + b) + c == a + (b + c)

(String, ++) e = ""

"" ++ x == x ++ "" == x (a ++ b) ++ c == a ++ (b ++ c)

Monad幺半群

Monad的范畴论定义中, 若将$$\mu $$当成幺半群的乘法, 则第一条公理类似幺半群的乘法结合律, 而第二条公理类似单位元的存在性(由$$\eta$$ 给出). 准确而言, $${\displaystyle {\mathcal {C}}}$$上的单子, 可以等价地定义为$${\displaystyle {\mathcal {C}}}$$的内函子范畴$${\displaystyle \mathbf {End} _{\mathcal {C}}}$$中的幺半群. 如此, 单子不仅在形式上具有与幺半群相似的公理, 甚而单子就是幺半群的特例.

对于Haskell中的Monad, 其单位元为return, 乘法为(>>=):

左单位元: m >>= return === m
右单位元: return a >>= k === k a
结合: m >>= (\x -> k x >>= h) === (m >>= k) >>= h

Monad例子

List, 集合

data List a = Nil | Cons a (List a)

instance Functor List where
    fmap _ Nil = Nil
    fmap f (Cons x xs) = Cons (f x) (fmap f xs)

instance Semigroup (List a) where
    Nil <> xs = Nil  
    Cons x xs <> ys = Cons x (xs <> ys)

instance Monoid (List a) where
    mempty = Nil

instance Applicative List where
    pure x = Cons x Nil
    Nil <*> _ = Nil
    _ <*> Nil = Nil
    Cons f fs <*> Cons x xs = Cons (f x) (fs <*> xs)

instance Monad List where
    Nil >>= f = Nil
    Cons x xs >>= f = f x <> (xs >>= f)

Result, 错误处理

data Result e a = Err e | Ok a

instance Functor (Result e) where
    fmap _ (Err e) = Err e
    fmap f (Ok a) = Ok (f a)

instance Applicative (Result e) where
    pure = Ok
    Err e <*> _ = Err e
    _ <*> Err e = Err e
    Ok f <*> Ok a = Ok (f a)

instance Monad (Result e) where
    Err e >>= k = Err e
    Ok a >>= k = k a

Promise, 异步

data Promise e a = Reject e | Resolve a

参考资料

https://zh.wikipedia.org/wiki/函子 https://zh.wikipedia.org/wiki/單子_(範疇論) https://zh.wikipedia.org/wiki/半群 https://hackage.haskell.org/package/base-4.18.0.0/docs/src/GHC.Base.html

Google IO 2023 记录 - Android 版本 Kotlin 的新动态

Thu, 18 May 2023 14:47:52 GMT

说是新动态, 其实内容大家基本上都见过了

前言

2017 Kotlin成为Android官方支持语言

2019 Android开发Kotlin优先, 文档和库都是主要为Kotlin设计的

如今, Play商店排行前1000中, 有95%使用Kotlin (包括依赖)

70%应用本身使用Kotlin

55%使用Kotlin协程

Jetpack Compose 是完全为Kotlin设计的, 充分利用了Kotlin语言特性

Google自2019将Kotlin普遍用于Android开发, 自2022年起将Kotlin用于服务端开发

Google中数以千计的开发者编写Kotlin代码, 版本控制系统有超过1500万行Kotlin代码

Kotlin 2.0编译器 (K2编译器)

性能提升两倍

路线图

See also

https://blog.jetbrains.com/kotlin/2023/02/k2-kotlin-2-0/

https://blog.jetbrains.com/kotlin/2021/10/the-road-to-the-k2-compiler/

测试K2编译器(Kotlin1.8.20)

使用命令行参数:

-language-version 2.0

或者使用Gradle配置:

kotlin {
   sourceSets.all {
       languageSettings {
           languageVersion = "2.0"
       }
   }
}

See also

https://kotlinlang.org/docs/whatsnew1820.html

Gradle Kotlin DSL

从Android Studio Giraffe开始, 项目模板将默认使用Gradle Kotlin DSL

和GroovyDSL相比, 得益于使用更多的静态类型, Gradle Kotlin DSL可以有更多的代码提示

并且可以通过转到定义查看更多文档

See also

https://docs.gradle.org/current/userguide/kotlin_dsl.html

Gradle版本目录(实验性功能)

使用TOML集中化管理依赖, 更加简明易维护

示例ibs.versions.toml

[versions]
com-android-application = "8.1.0-alpha11"
org-jetbrains-kotlin-android = "1.7.20"
core-ktx = "1.9.0"
junit = "4.13.2"
androidx-test-ext-junit = "1.1.3"
espresso-core = "3.4.0"
lifecycle-runtime-ktx = "2.3.1"
activity-compose = "1.5.1"
compose-bom = "2022.10.00"

[libraries]
core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "core-ktx" }
junit = { group = "junit", name = "junit", version.ref = "junit" }

See also

https://docs.gradle.org/current/userguide/platforms.html#sec:sharing-catalogs

https://developer.android.com/build/migrate-to-catalogs

Kotlin Symbol Processing (KSP)

kapt (Kotlin Annotation Processing Tool)

由kotlin代码生成Java stubs, 再由Java Annotation Processors处理

存在问题: 速度慢

ksp: kapt替代方案

直接分析Kotlin代码
速度提升两倍
更好支持Kotlin特性(如可空类型)
支持多平台项目

迁移到ksp

添加ksp插件

// 顶层声明插件版本
plugins {
    id 'com.google.devtools.ksp' version '1.8.10-1.0.9' apply false
}

// 应用插件
plugins {
    id 'com.google.devtools.ksp'
}

以ksp替换kapt

dependencies {
    kapt 'androidx.room:room-compiler:2.5.0'
    ksp 'androidx.room:room-compiler:2.5.0'
}

注意, 并非所有支持kapt的库都支持ksp, 需要库作者适配

目前支持ksp的项目: Room, Glide, Moshi, etc.

See also

https://developer.android.com/build/migrate-to-ksp

Kotlin Multiplatform (Beta)

使用Kotlin Multiplatform for Mobile(KMM)在Android和iOS中共享代码

See also

https://kotlinlang.org/docs/multiplatform-mobile-getting-started.html

一些Jetpack库开始支持Kotlin Multiplatform:

Annotations 1.7.0-alpha2
Collections 1.3.0-alpha4
DataStore 1.1.0-alpha3

See also

https://developer.android.com/kotlin/multiplatform?hl=zh-cn

https://android-developers.googleblog.com/2023/04/whats-new-in-jetpack-multiplatform.html

Zig 初见

Sun, 07 May 2023 19:11:43 GMT

什么是Zig?

Zig is a general-purpose programming language and toolchain for maintaining robust, optimal and reusable software.

按照官网所说, Zig是一种通用编程语言和工具链, 用于维护健壮、最佳和可重用的软件.

特点

无GC, 手动管理内存(支持arena等多种Allocator)
强大的编译时计算能力
类型可以在编译时像变量一样传递
超多Targets交叉编译
直接调用C语言代码和库

Hello, World

const std = @import("std");

pub fn main() !void {
    const stdout = std.io.getStdOut().writer();
    try stdout.print("Hello, {s}!\n", .{"world"});
}

通过 @import() 导入文件, 以 @ 开头的函数为编译器内置函数
!void 为 void 与 anyerror 的和类型

编译时计算

fn LinkedList(comptime T: type) type {
    return struct {
        pub const Node = struct {
            prev: ?*Node,
            next: ?*Node,
            data: T,
        };

        first: ?*Node,
        last:  ?*Node,
        len:   usize,
    };
}

test "linked list" {
    // Functions called at compile-time are memoized. This means you can
    // do this:
    try expect(LinkedList(i32) == LinkedList(i32));

    var list = LinkedList(i32) {
        .first = null,
        .last = null,
        .len = 0,
    };
    try expect(list.len == 0);

    // Since types are first class values you can instantiate the type
    // by assigning it to a variable:
    const ListOfInts = LinkedList(i32);
    try expect(ListOfInts == LinkedList(i32));
}

调用C语言

可以通过 zig translate-c 翻译C源文件为Zig源码, 甚至可以在Zig代码中通过 @cImport 直接导入C源文件和代码, 两者原理相同.

以调用OpenSSL计算MD5为例(Zig标准库支持MD5计算: std.crypto.hash.Md5, 此处仅为演示):

const std = @import("std");
const debug = std.debug;

const ssl = @cImport({
    @cInclude("openssl/ssl.h");
    @cInclude("openssl/crypto.h");
    @cInclude("openssl/md5.h");
}); // 导入OpenSSL头文件

fn md5sum(bytes: anytype) [ssl.MD5_DIGEST_LENGTH]u8 {
    comptime debug.assert(@TypeOf(bytes[0]) == u8);
    var md: [ssl.MD5_DIGEST_LENGTH]u8 = undefined;
    _ = ssl.MD5(bytes, bytes.len, &md); // 调用C函数
    return md;
}

在 build.zig 中添加链接库:

exe.linkSystemLibrary("libcrypto");  // 确保pkgconfig可以找到OpenSSL库, 此处就可以自动处理Include路径及链接库路径
exe.linkSystemLibrary("libssl");

内建Test

如同Go和Rust, Zig也内建test支持

test "simple test" {
    try std.testing.expectEqual(2, 1 + 1);
}

run:

zig test name.zig or zig build test

内存管理

arena示例

var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
defer arena.deinit();
const allocator = arena.allocator();
var map = std.StringHashMap([]const u8).init(allocator);
defer map.deinit();
try map.put("key", "value");
try testing.expect(std.mem.eql(u8, "value", map.get("key") orelse ""));

可空类型

var foo: ?i32 = null;

// Coerce from child type of an optional
foo = 1234;

// Use compile-time reflection to access the child type of the optional:
comptime try expect(@typeInfo(@TypeOf(foo)).Optional.child == i32);

// Pointers cannot be null. If you want a null pointer, use the optional
// prefix `?` to make the pointer type optional.
var ptr: ?*i32 = null;

var x: i32 = 1;
ptr = &x;

try expect(ptr.?.* == 1);

// Optional pointers are the same size as normal pointers, because pointer
// value 0 is used as the null value.
try expect(@sizeOf(?*i32) == @sizeOf(*i32));

错误处理

fn failingFunction() error{Oops}!void {
    return error.Oops;
}

test "returning an error" {
    failingFunction() catch |err| {
        try expect(err == error.Oops);
        return;
    };
}

交叉编译

$ zig targets

构建系统

$ zig help
Usage: zig [command] [options]

Commands:

  build            Build project from build.zig
  init-exe         Initialize a `zig build` application in the cwd
  init-lib         Initialize a `zig build` library in the cwd

  ast-check        Look for simple compile errors in any set of files
  build-exe        Create executable from source or object files
  build-lib        Create library from source or object files
  build-obj        Create object from source or object files
  fmt              Reformat Zig source into canonical form
  run              Create executable and run immediately
  test             Create and run a test build
  translate-c      Convert C code to Zig code

  ar               Use Zig as a drop-in archiver
  cc               Use Zig as a drop-in C compiler
  c++              Use Zig as a drop-in C++ compiler
  dlltool          Use Zig as a drop-in dlltool.exe
  lib              Use Zig as a drop-in lib.exe
  ranlib           Use Zig as a drop-in ranlib
  objcopy          Use Zig as a drop-in objcopy

  env              Print lib path, std path, cache directory, and version
  help             Print this help and exit
  libc             Display native libc paths file or validate one
  targets          List available compilation targets
  version          Print version number and exit
  zen              Print Zen of Zig and exit

General Options:

  -h, --help       Print command-specific usage

包管理

暂时还没有

Typst 体验

Thu, 20 Apr 2023 16:59:38 GMT

Typst是一个Rust编写的基于标记的排版系统, 正在积极开发中, 截至2023.5最新版本为0.3.0.

暂时取代LaTex不太现实, 因为各报刊杂志只会提供LaTex模板; 但是排版能力比MarkDown强太多, 可读性也比LaTex好, 而且很轻量, 只需要20MB(目前)的单二进制文件便可使用, 所以很适合处理一些轻量的排版任务.

官网: https://typst.app

GitHub: https://github.com/typst/typst

文档: https://typst.app/docs/

安装

macOS/Linux

brew install typst

Arch Linux

pacman -S typst

其他平台可参考https://github.com/typst/typst#installation

命令行使用

编译

typst compile file.typ

监听改动自动编译

typst watch file.typ

查看已安装字体

typst fonts

与vscode配合使用

Typst LSP插件提供了typst的lsp, 支持语法高亮和补全.

示例: 制作简历

语法很简单, 看一遍文档即可上手.

效果

代码

#set text(
    font: (
        // "Source Han Serif SC",  // 衬线字体, 用于打印
        // "Times New Roman",
        // "Songti SC",
        // "STSong",
        "Source Han Sans SC",  // 无衬线字体, 用于显示
        "Hiragino Sans GB",
        "Helvetica",
    ),
    size: 12pt,
    lang: "zh",
)
#set page(
    paper: "a4",
    margin: (x: 1.5cm, y: 1.5cm),
    footer: [
        #h(1fr) #text(fill: rgb("#d9d9d9"))[powered by typst]
    ]
)

#set par(justify: true)

// #show heading.where(level: 2): it => text(
//     weight: "medium",
//     it.body,
// )

#show link: underline

#let section_line() = {
    v(2pt); 
    line(length: 100%, stroke: 1pt + green); 
    v(-5pt);
}

= Alan

simpleslight\@icloud.com |
195\*\*\*\*2202 |
#link("https://github.com/suransea")[github.com/suransea] | 
#link("https://shoco.top")[shoco.top]

== Summary
#section_line()

#lorem(18)

== Key Skills
#section_line()

- #lorem(7)
- #lorem(6)
- #lorem(8)
- #lorem(7)
- #lorem(6)
- #lorem(9)

== Experience
#section_line()

==== #lorem(4) #h(1fr) 2021 --

- #lorem(10)
- #lorem(18)
- #lorem(15)
- #lorem(12)
- #lorem(19)
- #lorem(13)

==== #lorem(5) #h(1fr) 2020 -- 2021

- #lorem(19)
- #lorem(15)
- #lorem(10)
- #lorem(18)
- #lorem(13)

== Education
#section_line()

#lorem(3)

#lorem(4)

2020

ADB 常用命令

Tue, 18 Apr 2023 18:57:32 GMT

改变屏幕分辨率

adb shell wm size 1080x1920

测试不同屏幕比例适配时很有用, 可以通过

adb shell wm size reset

重置为默认分辨率

获取设备文字

adb exec-out uiautomator dump /dev/stdout

有时需要将设备上显示的一些文字复制到电脑上, 用这个命令配合grep可以快速完成

向设备输入文字

adb shell input text ""

向设备文本框输入文字, 可以用来传输文字到设备

查看设备代号

adb shell getprop | grep product

刷机时确认代号常用

查看当前活动

adb shell dumpsys activity activities | grep ResumedActivity

定位当前Activity

清除数据

adb shell pm clear com.example.app

bugreport

adb bugreport

IntelliJ IDEA 常用快捷键 (macOS)

Mon, 17 Apr 2023 17:42:14 GMT

格式化代码 command + option + L 优化导入 ^ + option + O 格式化代码选项 command + option + shift + L

返回 command + [ 前进 command + ]

最近文件 command + E 最近位置 command + shift + E 转到行列 command + L 转到上/下个函数 ^ + shift + up/down

复制一行 command + D, 相当于 command + C && command + V 删除一行 command + backspace 新起一行 shift + enter 上/下移一行 option + shift + up/down 上/下移部分 commang + shift + up/down

注释/取消 command + / 块注释/取消 option + command + /

查找 command + F 替换 command + R 所有文件中查找 command + shift + F 所有文件中替换 command + shift + R 查找任意 shift + shift

在匹配括号间移动 ^ + M 生成 command + N

重构 ^ + T 重命名 shift + F6

Gnome 开启分数缩放

Wed, 28 Sep 2022 14:30:29 GMT

参考链接: https://wiki.archlinux.org/title/HiDPI

Wayland

gsettings set org.gnome.mutter experimental-features "['scale-monitor-framebuffer']"

Xorg

gsettings set org.gnome.mutter experimental-features "['x11-randr-fractional-scaling']"

安装配置 LaTeX 环境, TeX Live + VSCode

Fri, 12 Aug 2022 10:25:11 GMT

安装TeX Live

macOS/Linux

$ brew install texlive

Linux下更推荐用自带包管理安装.

Windows

PS > choco install texlive

配置TeX Live

查看TeX Live包管理版本

$ tlmgr --version

测试安装包

$ tlmgr install latexindent

如果报错

tlmgr: action not allowed in system mode: install

则需要在命令上加上--usermode参数:

$ tlmgr install latexindent --usermode

如果报错

TLPDB: not a directory, not loading: /Users/xxx/texmf
cannot setup TLPDB in /Users/xxx/texmf at /usr/local/bin/tlmgr line 6887.

则先执行

$ tlmgr init-usertree

再执行安装命令.

随后可以安装一些常用包, 例如beamer:

$ tlmgr install beamer

配置VSCode

安装LaTeX Workshop扩展: https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop

打开扩展设置, 搜索 @ext:James-Yu.latex-workshop recipes

定位到 Latex-workshop › Latex: Recipes

点击 Edit in settings.json

将xelatex移动至第一位

"latex-workshop.latex.recipes": [
    {
        "name": "latexmk (xelatex)",
        "tools": [
            "xelatexmk"
        ]
    },
    ...
]

每次保存tex文件时会自动编译, 此行为可以通过配置

"latex-workshop.latex.autoBuild.run": "onFileChange"

来更改, 可选值为

onFileChange 监测到文件改动时
onSave 文件保存时
never 永不

遇到编译错误时, 如果原因为缺少包, 可以通过包管理tlmgr安装.

AndroidX 注解

Fri, 29 Jul 2022 11:23:47 GMT

@Nullable, @NonNull

用于修饰变量/参数/返回值. @Nullbale表示可空, @NonNull表示非空.

以下行为会生成警告:

将null/可空值赋值给非空变量/参数/字段
未进行null检查而直接调用可空值的方法/字段

此外, null注解也作用于Kotlin于Java交互:

@NonNull
String foo(@Nullable String a, @NonNull String b) {}

对应Kotlin函数签名:

fun foo(a: String?, b: String): String

Resource ID

表示目标资源ID的类型.

任意类型资源ID: @AnyRes

示例:

fun @receiver:AnyRes Int.uri() = "${SCHEME_ANDROID_RESOURCE}://${BuildConfig.APPLICATION_ID}/$this"

指定类型资源ID:

@StringRes, @LayoutRes, @DrawableRes, @DimenRes, @ColorRes, @InterpolatorRes, @IntegerRes, @IdRes, @StyleRes, @StyleableRes, @TransitionRes, @XmlRes, @RawRes, @PluralsRes, @MenuRes, @NavigationRes, @FontRes, @FractionRes, @BoolRes, @ArrayRes, @AttrRes, @AnimatorRes, @AnimRes

@ColorInt, @ColorLong

表示目标类型为ARGB Color.

示例:

public abstract void setTextColor(@ColorInt int color);

public void setFillColor(@ColorLong long color);

@Dimension

表示目标类型为尺寸类型.

示例:

@Dimension(unit = DP)
public int getDesiredHeight() {
    return mDesiredHeight;
}

@Px

等价于@Dimension(unit = PX).

@IntRange, @FloatRange

表示值的范围, 不符合会生成警告.

示例:

fun setAlpha(@FloatRange(from = 0.0, to = 1.0) alpha: Float) {...}

from, to参数可以仅指定一个.

@Size

表示集合或数组的大小.

可以指定以下参数:

@Size(min=1) 最小值
@Size(max=2) 最大值
@Size(multiple=2) 倍数
@Size(2) 准确值

@HalfFloat

表示short类型/short数组存储半精度16位浮点数, 详见android.util.Half.

@CheckResult

表示调用方应检查返回值.

常用于难以区分纯函数/修改自身的函数的情况, 例如:

public @CheckResult String trim(String s) { return s.trim(); }

s.trim(); // this is probably an error
s = s.trim(); // ok

@CallSuper

表示重写方法应调用super.

示例:

@CallSuper
override fun onCreate(savedInstanceState: Bundle?) {
}

线程

表示目标方法/目标类中全部方法需要从指定线程调用.

@MainThread

主线程

@UiThread

UI线程. 一般情况下与主线程相同, 如果有位于非主线程的View, 则可能表示其他线程.

@WorkerThread

工作线程

@BinderThread

Binder线程

@AnyThread

任意线程, 调用时无需考虑所在线程

@GuardedBy

表示目标方法或属性在访问时需持有指定锁.

示例:

final Object objectLock = new Object();

@GuardedBy("objectLock")
volatile Object object;

Object getObject() {
    synchronized (objectLock) {
        if (object == null) {
            object = new Object();
        }
    }
    return object;
}

@Discouraged

表示目标不鼓励使用, 比@Deprecated程度要轻.

示例:

@Discouraged(message = "It is much more efficient to retrieve "
                        + "resources by identifier than by name.")
public void getValue(String name) {
    ...
}

@DoNotInline

表示方法不要内联. 生效于混淆规则:

-keepclassmembers,allowobfuscation class * {
  @androidx.annotation.DoNotInline <methods>;
}

@Keep

表示目标应在编译时保留. 生效于混淆规则:

-keep,allowobfuscation @interface androidx.annotation.Keep
-keep @androidx.annotation.Keep class * {*;}

-keepclasseswithmembers class * {
    @androidx.annotation.Keep <methods>;
}

-keepclasseswithmembers class * {
    @androidx.annotation.Keep <fields>;
}

-keepclasseswithmembers class * {
    @androidx.annotation.Keep <init>(...);
}

可用于防止POJO类型混淆.

@RestrictTo

限制访问范围.

@RestrictTo(RestrictTo.Scope.SUBCLASSES) 子类
@RestrictTo(RestrictTo.Scope.LIBRARY) 库
@RestrictTo(RestrictTo.Scope.LIBRARY_GROUP) 相同GroupID
@RestrictTo(RestrictTo.Scope.LIBRARY_GROUP_PREFIX) 相同Group前缀
@RestrictTo(RestrictTo.Scope.TESTS) 测试, 等价于 @VisibleForTesting(otherwise = VisibleForTesting.NONE)

@VisibleForTesting

表示目标可见性大于本应具有的可见性, 扩大可见性的原因是用于测试. 参数为本应具有的可见性.

示例:

@VisibleForTesting(otherwise = VisibleForTesting.PRIVATE)
fun myMethod() {
    ...
}

@DisplayContext, @UiContext, @NonUiContext

@DisplayContext表示目标context是DisplayContext, 即可以用于getDisplay.

@UiContext表示目标context是UiContext, 即目标是DisplayContext, 并且可以用于获取UI相关服务(WindowManager, LayoutInflater, WallpaperManager).

@NonUiContext表示目标不是UiContext.

@IntDef, @StringDef

用于创建一个约束值注解, 常用于替代枚举.

示例:

@Retention(SOURCE)
@IntDef({NAVIGATION_MODE_STANDARD, NAVIGATION_MODE_LIST, NAVIGATION_MODE_TABS})
public @interface NavigationMode {}

public static final int NAVIGATION_MODE_STANDARD = 0;
public static final int NAVIGATION_MODE_LIST = 1;
public static final int NAVIGATION_MODE_TABS = 2;

public abstract void setNavigationMode(@NavigationMode int mode);

@NavigationMode
public abstract int getNavigationMode();

@GravityInt

表示目标int类型为Gravity, 详见android.view.Gravity.

应该等价于

@Retention(RetentionPolicy.SOURCE)
@IntDef(flag = true, value = {
    Gravity.FILL,
    Gravity.FILL_HORIZONTAL,
    Gravity.FILL_VERTICAL,
    Gravity.START,
    Gravity.END,
    Gravity.LEFT,
    Gravity.RIGHT,
    Gravity.TOP,
    Gravity.BOTTOM,
    Gravity.CENTER,
    Gravity.CENTER_HORIZONTAL,
    Gravity.CENTER_VERTICAL,
    Gravity.DISPLAY_CLIP_HORIZONTAL,
    Gravity.DISPLAY_CLIP_VERTICAL,
    Gravity.CLIP_HORIZONTAL,
    Gravity.CLIP_VERTICAL,
    Gravity.NO_GRAVITY
})
public @interface GravityFlags {}

@RequiresApi

表示目标需要具有指定或更高的API等级才能调用, 类似于android.annotation.TargetApi.

示例:

@RequiresApi(Build.VERSION_CODES.LOLLIPOP)
public void cubicToPoint(...);

@ChecksSdkIntAtLeast

表示目标方法/属性将检查ApiLevel.

示例:

@ChecksSdkIntAtLeast(api = Build.VERSION_CODES.O)
public static boolean isAtLeastO() {
    return Build.VERSION.SDK_INT >= 26;
}

void foo() {
    if (isAtLeastO()) {
        // call @RequiresApi(>=26) and no warning.
    }
}

@RequiresPermission

表示调用方需具有指定权限.

示例:

@RequiresPermission(Manifest.permission.SET_WALLPAPER)
public abstract void setWallpaper(Bitmap bitmap);

@RequiresPermission(allOf = {
    Manifest.permission.READ_EXTERNAL_STORAGE,
    Manifest.permission.ACCESS_MEDIA_LOCATION})
public static final void copyImageFile(String dest, String source) {
    //...
}

@RequiresPermission(android.Manifest.permission.BLUETOOTH)
public static final String ACTION_REQUEST_DISCOVERABLE =
            "android.bluetooth.adapter.action.REQUEST_DISCOVERABLE";

@RequiresPermission.Read(@RequiresPermission(READ_HISTORY_BOOKMARKS))
@RequiresPermission.Write(@RequiresPermission(WRITE_HISTORY_BOOKMARKS))
public static final Uri BOOKMARKS_URI = Uri.parse("content://browser/bookmarks");

@ContentView

表示目标构造函数接受一个LayoutRes参数, 并将设置为自身布局.

示例:

@ContentView
public Fragment(@LayoutRes int contentLayoutId) {
    this();
    mContentLayoutId = contentLayoutId;
}

@RequiresFeature

表示调用方应具有目标特性.

示例:

@RequiresFeature(PackageManager.FEATURE_BLUETOOTH)
public final class BluetoothManager {
    ...
}

Modem, Router, Switch, Hub...

Thu, 28 Jul 2022 17:56:40 GMT

Modem

调试解调器, 用于信号转换

Router

路由器, 根据IP地址在网络间传输/转发数据报

Switch

交换机, 根据MAC地址将数据报转发给目标接口

Hub

集线器, 将每个数据报广播到所有接口

Bridge

网桥, 可以为Hub局域网划分网段

AP

接入点, 无线交换机

Gateway

网关, 用于网络层以上网络互联

Swift 并发, 对比 Kotlin协程

Wed, 27 Jul 2022 16:12:56 GMT

Hello, 异步函数

func hello() async -> String {
    try? await Task.sleep(nanoseconds: 1000_000_000)
    return "hello"
}

Kotlin:

suspend fun hello(): String {
    delay(1.seconds)
    return "hello"
}

结构化并发

let task = Task {
    await hello()
}
task.cancel()

Kotlin:

val scope = CoroutineScope(EmptyCoroutineContext)
scope.launch(Dispatchers.Main) {
    hello()
}
scope.cancel()

Task

async标记的函数只能在async标记的函数或闭包中调用, Task的初始化器提供了async闭包环境:

public init(priority: TaskPriority? = nil, operation: @escaping @Sendable () async -> Success)

可选使用TaskPriority参数:

Task(priority: .high) {
    ...
}

取值:

high, medium, low,
userInitiated, utility, background,

后面三种等级类似于DispatchQos.

withUnsafeCurrentTask

如果要获取当前task, 可以使用withUnsafeCurrentTask:

withUnsafeCurrentTask { task in
    task?.isCancelled
    task?.priority
    task?.cancel()
    ...
}

此函数非async, 如果当前环境不存在task, task值为nil.

如果仅想检查任务优先级和任务是否取消, 可以直接使用Task.currentPriority和Task.isCancelled.

Task嵌套

对于Task嵌套的情况:

Task {
    Task {
        ...
    }
}

子Task会继承当前Task的环境(但仍然是独立的Task, 非结构化并发), 如果不想继承可以使用Task.detached(priority:operation:):

Task {
    Task.detached {
        ...
    }
}

CancelBag

task离开作用域时不会被取消, 如果需要可以仿照DisposeBag实现CancelBag(非线程安全):

public final class CancelBag {

    private var cancels = [() -> Void]()

    public func on(cancel: @escaping () -> Void) {
        self.cancels.append(cancel)
    }

    private func cancel() {
        cancels.forEach { cancel in cancel() }
    }
    
    deinit {
        self.cancel()
    }
}

extension Task {
    func cancel(by bag: CancelBag) {
        bag.on(cancel: { cancel() })
    }
}

使用:

let bag = CancelBag()

Task {
    ...
}.cancel(by: bag)

要注意循环引用. 如果不想在task闭包中处理循环引用, 可以使用手动的CancelBag:

public final class CancelBag {

    private var cancels = [() -> Void]()

    public func on(cancel: @escaping () -> Void) {
        self.cancels.append(cancel)
    }

    public func cancel() {
        cancels.forEach { cancel in cancel() }
        cancels.removeAll()
    }
}

并在适当时机调用bag.cancel().

async let

async let hello = hello()
async let world = world()
print("\(await hello) \(await world)")

Kotlin:

val hello = async { hello() }
val world = async { world() }
println("${hello.await()} ${world.await()}")

同时执行多个async函数. 比如发送网络请求时, 如果第三个请求的参数依赖前两个请求的结果:

async let x = reqX()
async let y = reqY()
let z = await reqZ(await x, await y)

可以让x, y请求同时发出, 都得到响应后, 再发出z请求

for await

func number() async -> Int {
    .random(in: 1...100)
}

await withTaskGroup(of: Int.self) { group in
    for _ in 1...100 {
        group.addTask { await number() }
    }
    
    for await i in group {
        print(i)
    }
}

Kotlin:

suspend fun number() = Random.nextInt(0..100)

val numbers = produce {
    coroutineScope {
        repeat(100) {
            launch { send(number()) }
        }
    }
}

for (i in numbers) {
    println(i)
}

for await用于迭代实现了AsyncSequence协议的类型, 如TaskGroup和下文将要提到的AsyncStream.

withTaskGroup(of:)效果类似于corountineScope, 可以添加一系列子任务并等待这些任务完成.

如果子Task会调用throws, 可以使用withThrowingTaskGroup:

try await withThrowingTaskGroup(of: Int.self) { group in
    group.addTask { throw SomeError() }

    for try await i in group {
	...
    }
}

await all

await withTaskGroup(of: Int.self) { group in
    for _ in 1...100 {
        group.addTask { await number() }
    }
    
    await group.reduce(into: []) { result, transition in result.append(transition) }
}

(1..100)
    .map { async { number() } }
    .awaitAll()

收集子任务结果.

AsyncStream

let stream = AsyncStream<Int> { continuation in
    for i in 1...100 {
        continuation.yield(i)
    }
    continuation.finish()
}

for await i in stream {
    print(i)
}

let stream = AsyncStream<Int> {
    try? await Task.sleep(nanoseconds: 1000_000_000)
    return .random(in: 1...100)
}

for await i in stream {
    print(i)
}

Kotlin:

flow {
    (1..10).forEach { emit(it) }
}.collect {
    println(it)
}

flow {
    while (true) {
        delay(1.seconds)
        emit(Random.nextInt(1..10))
    }
}.collect {
    println(it)
}

这里AsyncStream和flow对比比较直观, 但其行为更像ReceiveChannel, 因为flow是冷的.

Actor

actor Counter {
    var count: Int = 0
    
    func inc() {
        count += 1
    }
}

let couter = Counter()
await couter.inc()
let count = await couter.count

Kotlin:

sealed interface CounterMsg

object IncCount : CounterMsg
class GetCount(val response: CompletableDeferred<Int> = CompletableDeferred()) : CounterMsg

fun CoroutineScope.counterActor() = actor<CounterMsg> {
    var count = 0
    for (msg in channel) {
        when (msg) {
            is GetCount -> msg.response.complete(count)
            is IncCount -> ++count
        }
    }
}

suspend fun SendChannel<CounterMsg>.count() = GetCount().also { send(it) }.response.await()

val counter = counterActor()

counter.send(IncCount)
val count = counter.count()

Swift在语言层面支持了actor, 因此使用actor要比Kotlin方便许多.

从外部调用actor中的函数、可变属性和计算属性需要使用await. 如果确定不存在数据竞争, 可以用nonisolated修饰:

nonisolated func foo() -> String {
    ...
}

这样就可以像调用普通函数一样从外部调用.

GlobalActor

用@globalActor创建一个修饰器, 用此修饰器修饰, 可以让函数/属性/class共同使用一个actor环境:

@globalActor
actor BusActor: GlobalActor {
    public static let shared = BusActor()
}

@BusActor func foo() {
    ...
}

@BusActor var bar = 0

@BusActor class Bus {}

MainActor

MainActor是运行于主线程的GlobalActor:

@globalActor final public actor MainActor : GlobalActor

可以把更新UI的函数用@MainActor修饰:

@MainActor
func update() {
    ...
}

以保证此函数一定在主线程执行.

Sendable

Sendable是一个mark协议, 用于标记类型为可安全在actor间移动的, 类似于Rust的Sendtrait.

public protocol Sendable {
}

以下类型是Sendable的:

基本类型
actor类型
由Sendable类型构成的struct
满足以下条件的@Sendable修饰的函数或闭包:
- 捕获变量是Sendable类型
- 捕获变量不可变
满足以下条件的显式实现Sendable的class:
- final修饰, 即不可继承
- 存储属性是Sendable类型
- 存储属性不可变
- 无父类或父类是NSObject

如果确定不符合以上条件的class可以安全Send, 可以实现@unchecked Sendable以跳过编译检查:

class Foo: @unchecked Sendable {
}

从Callback迁移

func request(_ completion: (String) -> Void) {
    ...
}

func request() async -> String {
    await withCheckedContinuation { continuation in
        request { response in
            continuation.resume(returning: response)
        }
    }
}

Kotlin:

fun request(callback: (String) -> Unit) {
    ...
}

suspend fun request(): String = suspendCoroutine { continuation ->
    request {
        continuation.resume(it)
    }
}

如果闭包内调用了throws, 可以使用withCheckedThrowingContinuation(function:_:)

如果可以确保调用且仅调用一次resume, 可以使用unsafe版本:

withUnsafeContinuation(_:)
withUnsafeThrowingContinuation(_:)

Arch Linux 安装

Tue, 26 Jul 2022 16:22:45 GMT

安装

下载镜像

$ wget https://mirrors.tuna.tsinghua.edu.cn/archlinux/iso/latest/archlinux-x86_64.iso

wget可以替换成其他工具, 比如aria2c

mirrors list: https://archlinux.org/download/

制作启动U盘

# dd bs=4M if=archlinux-x86_64.iso of=/dev/sdx status=progress && sync

也可以使用GUI工具, 比如etcher, rufus(Windows)

以U盘启动

将U盘插入目标设备, 进入BIOS, 如果安全启动开启需要先关闭安全启动, 调整启动顺序后保存退出

如果设备支持快速启动, 也可以从快速启动中选中U盘启动

重启后, 如果一切顺利, 将会看到archinstall的shell

连接网络

参考{% post_link Linux命令行连接网络 %}

更新镜像

安装Reflector

# pacman -Syy reflector

# reflector --verbose --country China --latest 5 --protocol https --sort rate --save /etc/pacman.d/mirrorlist

启动安装脚本

# archinstall

按照步骤配置即可

后续步骤(供参考)

常用软件包索引: https://wiki.archlinux.org/title/List_of_applications_(简体中文)

安装git

$ sudo pacman -Syyu git

安装paru(AUR工具)

$ git clone https://aur.archlinux.org/paru-bin.git

$ cd paru-bin

$ makepkg -si

安装papirus图标包

$ sudo pacman -S papirus-icon-theme

安装字体

$ sudo pacman -S adobe-source-sans-fonts \
        adobe-source-han-sans-cn-fonts \
        adobe-source-han-sans-tw-fonts \
        adobe-source-han-sans-jp-fonts \
        adobe-source-han-sans-kr-fonts \
        noto-fonts noto-fonts-cjk

Swift 调用 GLib

Tue, 26 Jul 2022 14:22:39 GMT

g_signal_connect

Swift无法调用C宏, 需要使用g_signal_connect_data函数

let slot: @convention(c) (UnsafeMutableRawPointer?) -> Void = { data in
    ...
}
g_signal_connect_data(ptr, "signal", unsafeBitCast(slot, to: GCallback?.self), data, nil, G_CONNECT_AFTER)

slot必须标记为@convention(c), 否则unsafeBitCast将产生fatalError

g_object_get_property

func gproperty<T, R>(of ptr: UnsafeMutablePointer<T>, name: String, transform: (UnsafeMutablePointer<GValue>) -> R) -> R {
    ptr.withMemoryRebound(to: GObject.self, capacity: 1) {
        var value = GValue()
        g_object_get_property($0, name, &value)
        return transform(&value)
    }
}

再使用g_value_get族函数从GValue中获取值

let property = gproperty(of: ptr, name: "property") { g_value_get_variant($0) }

待续..

Android 安装系统CA证书

Tue, 26 Jul 2022 10:43:50 GMT

HTTPS抓包时, 如果应用不信任用户证书, 需要把证书安装为系统证书.

如果证书为二进制格式(cer, der), 需要先转换为文本格式

$ openssl x509 -inform der -in cert.cer -outform pem -out cert.pem

获取hash, 存为$CERT_HASH

$ CERT_HASH=`openssl x509 -inform pem -in cert.pem -subject_hash_old | head -1`

制作证书文件

$ cp cert.pem ${CERT_HASH}.0

$ openssl x509 -inform pem -in cert.pem -text -noout >> ${CERT_HASH}.0

push到设备中

$ adb root

$ adb remount

$ adb push ${CERT_HASH}.0 /system/etc/security/cacerts/

更改权限

$ adb shell chmod 644 /system/etc/security/cacerts/${CERT_HASH}.0

如果Android13以上无法remount, 可以尝试

$ adb shell setprop sys.debug.allow_remount true
$ adb shell stop && adb shell start

或者使用overlayfs

$ adb shell
$ mkdir -p /data/overlay/upper
$ mkdir -p /data/overlay/work
$ mount -t overlay overlay -o lowerdir=/system/etc/security/cacerts,upperdir=/data/overlay/upper,workdir=/data/overlay/work /system/etc/security/cacerts
$ exit
$ adb push ${CERT_HASH}.0 /data/overlay/upper/

或者使用mount --bind

$ adb shell
$ mkdir -p /data/mnt
$ adb push ${CERT_HASH}.0 /data/mnt/
$ mount --bind /data/mnt/${CERT_HASH}.0 /system/etc/security/cacerts/${CERT_HASH}.0

Android UID

Tue, 19 Jul 2022 11:21:47 GMT

UID

Linux会为每个用户分配一个uid, 可以用id命令查看:

$ id
uid=501(sea) gid=20(staff) groups=20(staff)...

root用户uid=0

而在Android系统中, 默认情况下，Android会为新安装应用分配uid, 范围[10000, 19999], 称之为appid

通过在manifest文件中指定android:sharedUserId=""可以更改此行为, 使用相同sharedUserId的应用需要使用相同的签名, 使用相同sharedUserId的应用之间可以直接访问数据, 甚至在同一进程中运行.

支持多用户后, Android的uid由两部分组成:

uid = userid * 100_000 + appid

使用ps查看进程, 可以看到用户名形如u0_a66

$ ps -ef
u0_a66       11391   484 0 11:37:58 ?     00:00:00 com.android.camera
...

则该进程userid为0, appid为10066, uid为0 * 100_000 + 10066 = 10066

编程中使用android.os.Process.myUid()可以获取当前uid

UserHandle

UserHandle为对userid的封装。

使用android.os.Process.myUserHandle()可以获取当前UserHandle

UserHandle中包含一些对uid进行转换的方法:

public static @UserIdInt int getUserId(int uid) // uid2userid

public static @AppIdInt int getAppId(int uid) // uid2appid

public static int getUid(@UserIdInt int userId, @AppIdInt int appId) // (userid+appid)2uid

UserHandle中包含一些预定义的userid:

public static final @UserIdInt int USER_ALL = -1;  // 全部用户

public static final @UserIdInt int USER_CURRENT = -2;  // 当前用户

public static final @UserIdInt int USER_CURRENT_OR_SELF = -3;  // 当前用户或当前应用用户

public static final @UserIdInt int USER_NULL = -10000;  // 未定义

public static final @UserIdInt int USER_OWNER = 0;  // 系统默认用户, 已弃用

public static final @UserIdInt int USER_SYSTEM = 0;  // 系统默认用户

UID System (uid=1000)

使用ps查看进程时, 可以看到名为system的用户:

$ ps -ef
system       19724   484 0 17:53:31 ?     00:06:57 com.android.settings:remote
...

该用户uid为1000, 开发系统应用时, 指定android:sharedUserId="android.uid.system", 并使用系统签名, 可以直接访问系统应用数据.

IPv6 常见问题

Mon, 20 Jun 2022 18:03:54 GMT

未指定地址

v4: 0.0.0.0

v6: ::

回环地址

v4: 127.0.0.1/8

v6: ::1

本地地址

v4: 169.254.0.0/16

v6: fe80::/10

临时地址

设备可能会获取到多个IPv6地址，包含临时地址和永久地址。由于没有NAT，IPv6地址会让你的设备暴露于整个网络中。因此，设备发起连接时默认使用临时地址，以减少受攻击的风险。

用于链接

v4: http://ipv4-address:port/

v6: http://[ipv6-address]:port/

即IPv6地址需要加方括号

本站已支持 IPv6

Mon, 20 Jun 2022 14:43:00 GMT

curl

$ curl -6v https://shoco.top        
*   Trying 2401:c080:1c02:10f9:5400:3ff:fece:b230:443...
* Connected to shoco.top (2401:c080:1c02:10f9:5400:3ff:fece:b230) port 443 (#0)
...

ping

$ ping6 -c 4 shoco.top
PING6(56=40+8+8 bytes) 2408:8607:1b00:1e:5067:f9e9:4fdc:fe64 --> 2401:c080:1c02:10f9:5400:3ff:fece:b230
16 bytes from 2401:c080:1c02:10f9:5400:3ff:fece:b230, icmp_seq=0 hlim=46 time=109.457 ms
16 bytes from 2401:c080:1c02:10f9:5400:3ff:fece:b230, icmp_seq=1 hlim=46 time=108.656 ms
16 bytes from 2401:c080:1c02:10f9:5400:3ff:fece:b230, icmp_seq=2 hlim=46 time=108.431 ms
16 bytes from 2401:c080:1c02:10f9:5400:3ff:fece:b230, icmp_seq=3 hlim=46 time=117.308 ms

--- shoco.top ping6 statistics ---
4 packets transmitted, 4 packets received, 0.0% packet loss
round-trip min/avg/max/std-dev = 108.431/110.963/117.308/3.683 ms

nslookup

$ nslookup -query=AAAA shoco.top
...
shoco.top	has AAAA address 2401:c080:1c02:10f9:5400:3ff:fece:b230
...

dig

$ dig AAAA shoco.top

; <<>> DiG 9.10.6 <<>> AAAA shoco.top
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 3514
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 8, ADDITIONAL: 9

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;shoco.top.			IN	AAAA

;; ANSWER SECTION:
shoco.top.		678	IN	AAAA	2401:c080:1c02:10f9:5400:3ff:fece:b230
...

APP View 整体变灰

Fri, 10 Jun 2022 17:34:46 GMT

背景

国内有些日期会要求APP整体置灰

Android

应用ColorMatrix设置饱和度为零

Kotlin

view.setLayerType(View.LAYER_TYPE_HARDWARE, Paint().apply {
    colorFilter = ColorMatrixColorFilter(ColorMatrix().apply { setSaturation(0F) })
})

Java

Paint paint = new Paint();
ColorMatrix colorMatrix = new ColorMatrix();
colorMatrix.setSaturation(0);
paint.setColorFilter(new ColorMatrixColorFilter(colorMatrix));
view.setLayerType(View.LAYER_TYPE_HARDWARE, paint);

iOS

添加layer并设置compositingFilter为saturationBlendMode，设置背景颜色为0饱和度颜色，如黑白灰，或者 UIColor(hue: 0, saturation: 0, brightness: 1, alpha: 1)

色相和亮度可以为[0, 1]任意值

Swift

let layer = CALayer()
layer.frame = view.frame
layer.compositingFilter = "saturationBlendMode"
layer.backgroundColor = UIColor.white.cgColor
view.layer.addSublayer(layer)

Objective-C

CALayer *layer = CALayer.new;
layer.frame = view.frame;
layer.compositingFilter = @"saturationBlendMode";
layer.backgroundColor = UIColor.whiteColor.CGColor;
[view.layer addSublayer:layer];

关于SaturationBlendMode: 应用为compositingFilter后会取当前layer的饱和度与其他layer的色相亮度混合，当前layer饱和度为0时也就间接将其他layer的饱和度设置为0

此外，可以用这种方式调整为任意灰度，即 grayscale = 1 - saturation

Linux 添加 SSH Keys

Wed, 08 Jun 2022 18:41:57 GMT

快速添加本地SSH公钥到服务器

如果有ssh-copy-id

$ ssh-copy-id USER@HOSTNAME

否则

$ cat ~/.ssh/id_rsa.pub | ssh USER@HOSTNAME "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

手动添加

Local

$ cat ~/.ssh/id_rsa.pub

如果文件不存在请先执行$ ssh-keygen

Server

$ vim ~/.ssh/authorized_keys

粘贴key到文件末尾，包含换行

Linux 命令行连接网络

Wed, 08 Jun 2022 11:00:07 GMT

有线连接

查看网卡

# ip link

获取IP地址

假设网卡为eth0

# dhcpcd eth0

无线连接 (Wi-Fi)

已安装iwd (iwctl)

进入交互模式

$ iwctl

列出所有可用的命令

[iwd]# help

列出所有 WiFi 设备

[iwd]# device list

扫描网络

[iwd]# station DEVICE scan

列出所有可用的网络

[iwd]# station DEVICE get-networks

连接网络

[iwd]# station DEVICE connect SSID

如果要求输入网络密码，将会提示用户输入。此外，连接操作可以应用成命令行参数的形式

$ iwctl --passphrase passphrase station DEVICE connect SSID

未安装iwd

查看网卡

# ip link

查看连接状态

假设网卡为wlan0

# iw dev wlan0 link

# iw dev wlan0 scan

连接网络

快速连接

# wpa_supplicant -B -i wlan0 -c <(wpa_passphrase SSID passphrase)

-B - Fork into background.
-i interface - Interface to listen on.
-c filename - Path to configuration file.

由于存在进程替换，这个命令不能以 sudo 方式执行，必须切换到 root 身份

使用wpa_cli

# wpa_cli

> scan

OK
<3>CTRL-EVENT-SCAN-RESULTS

> scan_results

bssid / frequency / signal level / flags / ssid
00:00:00:00:00:00 2462 -49 [WPA2-PSK-CCMP][ESS] MYSSID
11:11:11:11:11:11 2437 -64 [WPA2-PSK-CCMP][ESS] ANOTHERSSID

> add_network

> set_network 0 ssid "MYSSID"

> set_network 0 psk "passphrase"

> enable_network 0

<2>CTRL-EVENT-CONNECTED - Connection to 00:00:00:00:00:00 completed (reauth) [id=0 id_str=]

> save_config

OK

ADB 使用

Tue, 07 Jun 2022 20:06:11 GMT

ADB

安装

已安装Android SDK:

export PATH=$PATH:/path/to/Android/sdk/platform-tools

不安装Android SDK:

$ brew install android-platform-tools

通过WLAN连接

Android 11以上:

$ adb pair ipaddr:port $ adb connect ipaddr:port

Android11以下：

先连接USB

$ adb tcpip <port>

随后可以断开USB连接

$ adb connect ipaddr:port

查看已连接设备

$ adb devices -l

停止daemon

$ adb kill-server

指定设备

$ adb devices

List of devices attached
emulator-5555 device

$ adb -s emulator-5555 install /path/to/some.apk

不会引起歧义时，也可以-e指定模拟器，-d指定物理设备。

端口转发(设备端口给主机访问)

$ adb forward tcp:port tcp:port

顺序: LOCAL REMOTE

反向代理(主机端口给设备访问)

$ adb reverse tcp:port tcp:port

顺序: REMOTE LOCAL

复制文件

$ adb pull /remote/path /local/path

$ adb push /local/path /remote/path

Shell

$ adb shell

安装应用

$ adb install /local/path/to/some.apk

$ adb shell pm install /device/path/to/some.apk

卸载应用

$ adb uninstall <pkg_name>

$ adb shell pm uninstall <pkg_name>

截图

$ adb shell screencap /sdcard/demo.png

录屏

$ adb shell screenrecord /sdcard/demo.mp4

logcat

$ adb logcat -b all -v color '*:D'

Hexo 搭建, 部署到自定义 server

Tue, 07 Jun 2022 17:10:25 GMT

Hexo 搭建, 部署到自定义 server

使用Hexo搭建blog，部署到服务器上

Server配置

安装http服务

安装Apache2可参考 {% post_link Apache2-配置https %}

创建git用户

$ adduser git

修改git用户shell

# vim /etc/passed

定位到

git:x:1000:1000:,,,:/home/git:/bin/bash

将shell修改为/bin/git-shell

创建blog仓库

$ cd /home/git

# sudo -u git mkdir blog.git (以git用户执行命令，下同)

$ cd blog.git

# sudo -u git git init --bare

clone到Web目录

# rm -rf /var/www/html

# sudo -u git git clone /home/git/blog.git /var/www/html

设置hooks

$ cd /home/git/blog.git/hooks

# sudo -u git cp post-update.sample post-update

$ vim post-update

修改内容为

#!/bin/sh

unset $(git rev-parse --local-env-vars)
cd /var/www/html
git pull -f

创建hexo仓库（非必需，hexo项目可以放到本地或GitHub等其他位置）

$ cd /home/git

# sudo -u git mkdir hexo-blog.git

$ cd hexo-blog.git

# sudo -u git git init --bare

至此服务端配置完成。

Local配置

安装npm

$ brew install npm

or $ choco install nodejs

or $ winget install OpenJS.NodeJS

安装hexo

$ npm install hexo-cli -g

创建hexo-blog

$ hexo init hexo-blog

$ cd hexo-blog

$ git init && git add --all && git commit -m "Initial Commit"

$ git remote add origin ssh://git@yourdomain/home/git/hexo-blog.git

$ git push -u origin master

本地预览

$ hexo server

安装NexT主题 (可选)

$ git clone https://github.com/theme-next/hexo-theme-next themes/next

修改主题为next

$ vim _config.yml

...
theme: next
...

初始化配置

$ cp themes/next/_config.yml ./source/_data/next.yml

$ vim source/_data/next.yml

修改override为true

...
override: true
...

此后使用next.yml来配置NexT主题。

安装hexo-deployer-git

$ npm install hexo-deployer-git --save

$ vim _config.yml

配置仓库

...
deploy:
  type: git
  repo: ssh://yourdomain/home/git/blog.git
  branch: master
...

测试部署

$ hexo clean && hexo deploy

访问https://yourdomain测试是否部署成功

WordPress 搭建

Tue, 07 Jun 2022 15:56:09 GMT

WordPress搭建

debian下搭建WordPress

安装Apache2

参考{% post_link Apache2-配置https %}

安装Mariadb

# apt install mariadb-server

# mysql_secure_installation

安装PHP

# apt install php

安装WordPress

下载

$ wget https://wordpress.org/latest.tar.gz

解压

$ tar -zxvf ./lastest.tar.gz

复制到Web目录

$ cp -R ./wordpress/* /var/www/html/

安装

访问 https://yourdomain/wp-admin/install.php`

WordPress安装至此已完成。

后续步骤：

安装PHP插件

访问站点健康页，可以看到缺少的php插件。

通过$ apt install php-插件名 进行安装

配置SMTP

访问插件页 https://yourdomain/wp-admin/plugins.php

安装并启用WP Mail SMTP插件

按照向导配置SMTP，邮箱密码可能需要生成应用专用密码。

允许上传头像

安装Simple Local Avatars插件。

禁用图片压缩

安装Disable "BIG image" Threshold插件。

Linux 修改 hostname

Tue, 07 Jun 2022 15:51:09 GMT

查看当前hostname

$ hostnamectl

修改hostname

$ hostnamectl set-hostname mydomain.com

编辑/etc/hosts

# vim /etc/hosts

...
127.0.1.1 mydomian.com mydomain
127.0.0.1 localhost
...

Apache 服务器安装, 配置 HTTPS

Tue, 07 Jun 2022 11:48:01 GMT

Apache服务器安装，配置HTTPS

Debian环境，安装Apache2，使用acme.sh配置https

安装Apache2

# apt install apache2

安装acme.sh

$ curl https://get.acme.sh | sh -s email=my@example.com

$ source ~/.bashrc

签发证书

$ acme.sh --issue -d mydomain.com -d www.mydomain.com --apache

签发前请确保相关域名已正确解析到该server上。

安装证书

$ acme.sh --install-cert -d mydomain.com \
	  --cert-file      /path/to/cert.pem  \
	  --key-file       /path/to/key.pem  \
	  --fullchain-file /path/to/fullchain.pem \
	  --reloadcmd     "systemctl restart apache2"

这个命令同时会用于刷新证书，请确保reloadcmd正常工作

修改apache2配置

# vim /etc/apache2/sites-available/default-ssl.conf

...
SSLCertificateFile	  /path/to/cert.pem
SSLCertificateKeyFile     /path/to/key.pem
SSLCertificateChainFile   /path/to/fullchain.pem
...

启用SSL

# a2enmod ssl

# a2ensite default-ssl.conf

http重定向到https

# vim /etc/apache2/sites-available/000-default.conf

...
ServerName mydomain.com
RewriteEngine on
RewriteCond   %{HTTPS} !=on
RewriteRule   ^(.*)  https://%{SERVER_NAME}$1 [L,R=301]
...

# a2enmod rewrite

重启apache2

# systemctl restart apache2

PLL & COLL & OLL

Sat, 04 Jun 2022 18:37:51 GMT