b9753aa016
Eleven translated pages changed in English since the last release without matching updates: system requirements, the Lint tab, AI chat diff tools, collaboration with agents, design JSX imports and export fidelity, Storybook and live-app export, lint fixes, page navigation, and Checking Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections the abridged translations lacked where a change landed, use each language's UI labels, and point the export page at documents list.
4.9 KiB
Primeros pasos
Versión web
OpenPencil funciona directamente en el navegador y no requiere instalación. Abre app.openpencil.dev para empezar a diseñar.
Si quieres crear un producto basado en OpenPencil en lugar de limitarte a la aplicación predeterminada, consulta la sección Automatización y la documentación del Vue SDK.
Aplicación de escritorio
Las versiones preparadas para macOS, Windows y Linux están disponibles en la página de versiones.
| Plataforma | Archivo |
|---|---|
| macOS (Apple Silicon) | .dmg (aarch64) |
| macOS (Intel) | .dmg (x64) |
| Windows (x64) | .msi / .exe |
| Windows (ARM) | .msi / .exe |
| Linux (x64) | .AppImage / .deb |
Requisitos del sistema
OpenPencil dibuja con CanvasKit sobre WebGL y usa funciones recientes de la plataforma web, por lo que necesita un motor de navegador actual. La versión web admite Chrome 111, Edge 111, Firefox 128 y Safari 16.4 o posteriores; los navegadores basados en Chromium, como Brave u Opera, siguen la versión de Chrome en la que se basan. La aplicación de escritorio dibuja en el WebView del sistema, así que el mínimo depende del motor del sistema operativo:
| Plataforma | Requisito |
|---|---|
| macOS | macOS 13 Ventura o posterior con las actualizaciones actuales de Safari instaladas (Safari 16.4 se incluyó con macOS 13.3). |
| Windows | Windows 10 o posterior con el runtime Evergreen de Microsoft Edge WebView2, que se actualiza solo. |
| Linux | WebKitGTK 2.40 o posterior (webkit2gtk-4.1). |
Si el motor es demasiado antiguo, OpenPencil muestra qué debes actualizar en lugar de una ventana en blanco. Si ves ese aviso en un sistema que cumple los requisitos, usa su enlace «Report a problem», que rellena de antemano los datos del navegador y del motor.
Instalación en macOS con Homebrew
brew install --cask openpencil
El comando instala la aplicación firmada para Mac con Apple Silicon o procesador Intel desde el catálogo oficial de Homebrew. Homebrew revisa las actualizaciones, que pueden aparecer después de las versiones en GitHub. Mientras tanto, utiliza la descarga directa. La CLI se instala por separado: npm install -g @open-pencil/cli.
Si usabas el tap propio archivado, migra con:
brew uninstall open-pencil/tap/open-pencil
brew install --cask openpencil
Compilación desde el código fuente
Requisitos
Instalación
git clone https://github.com/open-pencil/open-pencil.git
cd open-pencil
bun install
Servidor de desarrollo
bun run dev
El editor estará disponible en http://localhost:1420.
Comandos
| Comando | Finalidad |
|---|---|
bun run dev |
Inicia el servidor de desarrollo con HMR |
bun run build |
Genera la versión de producción |
bun run check |
Ejecuta oxlint y comprueba los tipos con tsgo |
bun run test |
Ejecuta las pruebas E2E y de regresión visual con Playwright |
bun run test:update |
Actualiza las capturas de referencia |
bun run test:unit |
Ejecuta las pruebas unitarias con bun:test |
bun run docs:dev |
Inicia el servidor de desarrollo de la documentación |
bun run docs:build |
Genera rápidamente la documentación para verificarla en local |
bun run docs:build:production |
Genera la documentación completa para su publicación, incluidos los archivos para LLM |
Aplicación Tauri
Para compilar la aplicación Tauri se necesitan Rust y los componentes del sistema correspondientes a cada plataforma.
macOS
xcode-select --install
cargo install tauri-cli --version "^2"
bun run tauri dev
Windows
- Instala Rust con el toolchain
stable-msvc:rustup default stable-msvc - Instala Visual Studio Build Tools y selecciona el workload Desktop development with C++.
- WebView2 ya está incluido en Windows 10 a partir de la versión 1803 y en Windows 11.
- Ejecuta:
bun run tauri dev
Linux
En Debian o Ubuntu, instala las dependencias del sistema:
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
Después, ejecuta:
bun run tauri dev
Generar un paquete de instalación
bun run tauri build # Plataforma actual
bun run tauri build --target universal-apple-darwin # Universal Binary para macOS