Merge branch 'v2' into barcode-scanner-mdx

Author: mc-8

packages/plugins-workspace

@@ -10,7 +10,7 @@ Code signing is required on macOS to allow your application to be listed in the
 
 ## Prerequisites
 
-Code signing on macOS requires an [Apple Developer] account which is either paid (99$ per year) or on the free plan. You also need an Apple device where you perform the code signing. This is required by the signing process and due to Apple's Terms and Conditions.
+Code signing on macOS requires an [Apple Developer] account which is either paid (99$ per year) or on the free plan (only for testing and development purposes). You also need an Apple device where you perform the code signing. This is required by the signing process and due to Apple's Terms and Conditions.
 
 :::note
 Note when using a free Apple Developer account, you will not be able to notarize your application and it will still show up as not verified when opening the app.

packages/tauri

@@ -0,0 +1,92 @@
+---
+title: Localhost
+description: Usa un servidor localhost en aplicaciones en producción.
+plugin: localhost
+i18nReady: true
+---
+
+import PluginLinks from '@components/PluginLinks.astro';
+import Compatibility from '@components/plugins/Compatibility.astro';
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+import CommandTabs from '@components/CommandTabs.astro';
+
+<PluginLinks plugin={frontmatter.plugin} showJsLinks={false} />
+
+Expone los recursos de tu aplicación a través de un servidor localhost en lugar de usar el protocolo personalizado por defecto.
+
+:::caution
+Este plugin conlleva riesgos de seguridad considerables y solo debes usarlo si sabes lo que estás haciendo. Si tienes dudas, utiliza la implementación del protocolo personalizado por defecto.
+:::
+
+## Plataformas soportadas
+
+<Compatibility plugin={frontmatter.plugin} />
+
+## Configuración
+
+Instala el plugin localhost para comenzar.
+
+<Tabs>
+    <TabItem label="Automático">
+
+        Usa el gestor de paquetes de tu proyecto para añadir la dependencia:
+
+        <CommandTabs npm="npm run tauri add localhost"
+        yarn="yarn run tauri add localhost"
+        pnpm="pnpm tauri add localhost"
+        deno="deno task tauri add localhost"
+        bun="bun tauri add localhost"
+        cargo="cargo tauri add localhost" />
+
+    </TabItem>
+    <TabItem label="Manual">
+
+        <Steps>
+
+        1.  Ejecuta el siguiente comando en la carpeta `src-tauri` para añadir el plugin a las dependencias del proyecto en `Cargo.toml`:
+
+            ```sh frame=none
+            cargo add tauri-plugin-localhost
+            ```
+
+        2.  Modifica `lib.rs` para inicializar el plugin:
+
+            ```rust title="src-tauri/src/lib.rs" ins={4}
+            #[cfg_attr(mobile, tauri::mobile_entry_point)]
+            pub fn run() {
+                tauri::Builder::default()
+                    .plugin(tauri_plugin_localhost::Builder::new().build())
+                    .run(tauri::generate_context!())
+                    .expect("error al ejecutar la aplicación tauri");
+            }
+            ```
+
+        </Steps>
+
+</TabItem>
+</Tabs>
+
+## Uso
+
+El plugin localhost está disponible en Rust.
+
+```rust title="src-tauri/src/lib.rs" {4} {7-14}
+use tauri::{webview::WebviewWindowBuilder, WebviewUrl};
+
+pub fn run() {
+  let port: u16 = 9527;
+
+  tauri::Builder::default()
+      .plugin(tauri_plugin_localhost::Builder::new(port).build())
+      .setup(move |app| {
+          let url = format!("http://localhost:{}", port).parse().unwrap();
+          WebviewWindowBuilder::new(app, "main".to_string(), WebviewUrl::External(url))
+              .title("Ejemplo de Localhost")
+              .build()?;
+          Ok(())
+      })
+      .run(tauri::generate_context!())
+      .expect("error al ejecutar la aplicación tauri");
+}
+```

src/content/docs/distribute/Sign/macos.mdx

@@ -70,6 +70,12 @@ Install the Single Instance plugin to get started.
 
 </Tabs>
 
+:::info
+
+The Single Instance plugin must be the first one to be registered to work well. This assures that it runs before other plugins can interfere.
+
+:::
+
 ## Usage
 
 The plugin is already installed and initialized, and it should be functioning correctly right away. Nevertheless, we can also enhance its functionality with the `init()` method.

src/content/docs/es/plugin/localhost.mdx

@@ -351,16 +351,18 @@ export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"
 
 ```ps
 [System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "$env:LocalAppData\Android\Sdk", "User")
-$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk"
+$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk" | Select-Object -Last 1
 [System.Environment]::SetEnvironmentVariable("NDK_HOME", "$env:LocalAppData\Android\Sdk\ndk\$VERSION", "User")
 ```
 
 :::tip
-PowerShell will not pick up the new environment variables until reboot or logout,
-However you can refresh the current session:
+Most apps don't refresh their environment variables automatically, so to let them pickup the changes,
+you can either restart your terminal and IDE or for your current PowerShell session, you can refresh it with
 
-````ps
+```ps
 [System.Environment]::GetEnvironmentVariables("User").GetEnumerator() | % { Set-Item -Path "Env:\$($_.key)" -Value $_.value }
+```
+
 :::
 
 </TabItem>
@@ -371,7 +373,7 @@ However you can refresh the current session:
 
 ```sh
 rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android
-````
+```
 
 Next: [Setup for iOS](#ios) or [Create a project](/start/create-project/).