Use mkcert to provide certificate support for rsbuild https development services.
- Installation dependencies
yarn add rsbuild-plugin-mkcert -D
- Configure rsbuild
import {defineConfig} from'@rsbuild/core'
import mkcert from'rsbuild-plugin-mkcert'
// https://rsbuild.dev/config/
export default defineConfig({
plugins: [mkcert()]
})
Custom hosts, default value is localhost
+ local ip addrs
.
Whether to force generate.
Whether to automatically upgrade mkcert
.
Specify the download source of mkcert
, domestic users can set it to coding
to download from the coding.net mirror, or provide a custom BaseSource.
If the network is restricted, you can specify a local mkcert
file instead of downloading from the network.
The location to save the files, such as the downloaded mkcert program and the generated CA file, private key and certificate file, etc. Default value is PLUGIN_DATA_DIR
The name of private key file generated by mkcert
The name of cert file generated by mkcert
For the certificates to be trusted on mobile devices, you will have to install the root CA. It's the rootCA.pem
file in the folder printed by mkcert -CAROOT
.
On iOS, you can either use AirDrop, email the CA to yourself, or serve it from an HTTP server. After opening it, you need to install the profile in Settings > Profile Downloaded and then enable full trust in it.
For Android, you will have to install the CA and then enable user roots in the development build of your app. See this StackOverflow answer.
Set the environment variable DEBUG
=rsbuild:plugin:mkcert
Use mkcert to install the local CA
certificate and generate it for server.https Server certificate.
- Uninstall the
CA
certificate:mkcert -uninstall