Merge branch 'master' into vietnamese_translation

Jonny Borges · GitHub
Commit 3880e00c146bd2e6be66b5fb90ddbd4a610067b8 3880e00c 2 parents 423479c3 92b44a05
Showing 4 changed files with 100 additions and 64 deletions
README-es.md
lib/get_connect/connect.dart
lib/get_connect/http/src/response/response.dart
lib/get_navigation/src/extension_navigation.dart
--- a/README-es.md
View file @3880e00
+++ b/README-es.md
View file @3880e00
@@ -17,11 +17,9 @@
 <h3>Lamentamos la inconsistencia en la traducción. El paquete GetX se actualiza con bastante frecuencia y es posible que las traducciones a documentos no sean tan rápidas. Entonces, para que esta documentación aún tenga todo el contenido, dejaré aquí todos los textos nuevos sin traducir (considero que es mejor tener los documentos en inglés que no tenerlos), por lo que si alguien quiere traducir, sería de gran ayuda 😁</h3>
-- [Communication and support channels:](#communication-and-support-channels)
 - [Sobre GetX](#sobre-getx)
-- [Como contribuir](#como-contribuir)
-- [Installing](#installing)
-- [Proyecto Counter no GetX](#proyecto-counter-no-getx)
+- [Instalación](#instalación)
+- [Proyecto contador con GetX](#proyecto-contador-con-getx)
 - [Los tres pilares](#los-tres-pilares)
   - [Gestión del Estado](#gestión-del-estado)
     - [Reactivo STATE_MANAGER](#reactivo-state_manager)
@@ -37,25 +35,21 @@
   - [Otras API avanzadas y configuraciones manuales](#otras-api-avanzadas-y-configuraciones-manuales)
     - [Configuraciones globales opcionales](#configuraciones-globales-opcionales)
   - [Video explanation of Other GetX Features](#video-explanation-of-other-getx-features)
-- [Rompiendo cambios desde 2.0](#rompiendo-cambios-desde-20)
+- [Cambios importantes desde 2.0](#cambios-importantes-desde-20)
 - [¿Por qué Getx?](#por-qué-getx)
-
-# Communication and support channels:
-
-[**Slack (Inglés)**](https://communityinviter.com/apps/getxworkspace/getx)
-
-[**Discord (Ingles y Portugués)**](https://discord.com/invite/9Y3wK9)
-
-[**Telegram (Portugués)**](https://t.me/joinchat/PhdbJRmsZNpAqSLJL6bH7g)
+- [Comunidad](#comunidad)
+  - [Canales de la comunidad](#canales-de-la-comunidad)
+  - [Cómo contribuir](#cómo-contribuir)
+  - [Artículos y vídeos](#artículos-y-vídeos-inglés)
 # Sobre GetX
-- GetX es una solución extra ligera y potente para Flutter. Combina gestión de estádo de alto rendimiento, inyección de dependencia inteligente y gestión de rutas, de forma rápida y práctica.
+- GetX es una solución extra ligera y potente para Flutter. Combina gestión de estádo de alto rendimiento, inyección de dependencia inteligente y gestión de rutas de forma rápida y práctica.
 - GetX tiene 3 principios básicos, esto significa que esta es la prioridad para todos los recursos de la biblioteca.
-  **PERFORMANCE:** GetX se centra en el rendimiento y el consumo mínimo de recursos. Los puntos de referencia casi siempre no son importantes en el mundo real, pero si lo desea, aquí hay un indicador de consumo.([benchmarks](https://github.com/jonataslaw/benchmarks)), donde GetX lo hace mejor que otros enfoques de gestión estatal, por ejemplo. La diferencia no es grande, pero muestra nuestra preocupación por no desperdiciar sus recursos.
-  **PRODUCTIVITY:** GetX utiliza una sintaxis fácil y agradable.
-  **ORGANIZATION:** GetX permite el desacoplamiento total de la vista de la lógica empresarial.
+  - **RENDIMIENTO:** GetX se centra en el rendimiento y el consumo mínimo de recursos. Los puntos de referencia casi siempre no son importantes en el mundo real, pero si lo desea, aquí hay un indicador de consumo.([benchmarks](https://github.com/jonataslaw/benchmarks)), donde GetX lo hace mejor que otros enfoques de gestión estatal, por ejemplo. La diferencia no es grande, pero muestra nuestra preocupación por no desperdiciar sus recursos.
+  - **PRODUCTIVIDAD:** GetX utiliza una sintaxis fácil y agradable.
+  - **ORGANIZACIÓN:** GetX permite el desacoplamiento total de la vista de la lógica de negocio.
 * GetX ahorrará horas de desarrollo y extraerá el máximo rendimiento que su aplicación puede ofrecer, siendo fácil para los principiantes y precisa para los expertos. Navega sin contexto, abre diálogos, snackbars o bottomsheets desde cualquier lugar de tu código, gestiona estados e inyecta dependencias de forma fácil y práctica. Get es seguro, estable, actualizado y ofrece una amplia gama de API que no están presentes en el marco predeterminado.
@@ -63,54 +57,38 @@
 **GetX hace que su desarrollo sea productivo, pero ¿quiere hacerlo aún más productivo? [Agregue la extensión a su VSCode](https://marketplace.visualstudio.com/items?itemName=get-snippets.get-snippets)**
-# Como contribuir
-
-_¿Quieres contribuir al proyecto? Estaremos orgullosos de destacarte como uno de nuestros colaboradores. Aquí hay algunos puntos en los que puede contribuir y hacer que GetX (y Flutter) sea aún mejor._
+# Instalación
-- Ayudando a traducir el archivo Léame a otros idiomas.
-
-- Agregar documentación al archivo Léame (ni siquiera la mitad de las funciones de GetX han sido documentadas todavía).
-
-- Escriba artículos o haga videos que enseñen cómo usar GetX (se insertarán en el archivo Léame y en el futuro en nuestro Wiki).
-
-- Ofreciendo PRs para código/pruebas.
-
-- Incluyendo nuevas funciones.
-
-# Installing
-
-Add Get to your pubspec.yaml file:
+Añada la librería Get en tu archivo pubspec.yaml:
 ```yaml
 dependencies:
   get:
 ```
-Importar archivos get que se utilizarán:
+Importe Get en los archivos en los que se utilizará:
 ```dart
 import 'package:get/get.dart';
 ```
-# Proyecto Counter no GetX
+# Proyecto Contador con GetX
 Vea una explicación más detallada de la administración del estado [aquí](./documentation/es_ES/state_management.md). Allí verá más ejemplos y también la diferencia entre el Gestión del Estado simple y el Gestión del Estado reactivo
 El proyecto "contador" creado por defecto en un nuevo proyecto en Flutter tiene más de 100 líneas (con comentarios). Para mostrar el poder de GetX, demostraré cómo hacer un "contador" cambiando el estado con cada clic, cambiando de página y compartiendo el estado entre pantallas, todo de manera organizada, separando la vista de la lógica de negocio, SOLO 26 LÍNEAS DE CÓDIGO INCLUIDOS COMENTARIOS.
-- Paso 1:  
-  Agregue "Get" antes de su materialApp, convirtiéndolo en GetMaterialApp
+- Paso 1: Agregue "Get" antes de su materialApp, convirtiéndolo en GetMaterialApp
 ```dart
 void main() => runApp(GetMaterialApp(home: Home()));
 ```
-**Nota**: esto no modifica el MaterialApp del Flutter, GetMaterialApp no es una MaterialApp modificado, es solo un Widget preconfigurado, que tiene como child un MaterialApp por defecto. Puede configurar esto manualmente, pero definitivamente no es necesario. GetMaterialApp creará rutas, las inyectará, inyectará traducciones, inyectará todo lo que necesita para la navegación de rutas. Si usa Get solo para la gestión de estado o dependencias, no es necesario usar GetMaterialApp. GetMaterialApp es necesario para rutas, snackbars, internacionalización, bottomSheets, diálogos y APIs de alto nivel relacionadas con rutas y ausencia de contexto.
+**Nota**: esto no modifica el MaterialApp del Flutter, GetMaterialApp no es una MaterialApp modificado, es solo un Widget preconfigurado que tiene como child un MaterialApp por defecto. Puede configurar esto manualmente, pero definitivamente no es necesario. GetMaterialApp creará rutas, las inyectará, inyectará traducciones, inyectará todo lo que necesita para la navegación de rutas. Si usa Get solo para la gestión de estado o dependencias, no es necesario usar GetMaterialApp. GetMaterialApp es necesario para rutas, snackbars, internacionalización, bottomSheets, diálogos y APIs de alto nivel relacionadas con rutas y ausencia de contexto.
-**Note²:** Este paso solo es necesario si vas a usar route management (`Get.to()`, `Get.back()` y así). Si no lo va a usar, no es necesario que realice el paso 1
+**Nota²:** Este paso solo es necesario si va a usar route management (`Get.to()`, `Get.back()` y así). Si no lo va a usar, no es necesario que realice el paso 1
-- Paso 2:  
-  Cree su clase con la lógica de negocio colocando todas las variables, métodos y controladores dentro de ella. Puede hacer que cualquier variable sea observable usando un simple ".obs".
+- Paso 2: Cree su clase con la lógica de negocio colocando todas las variables, métodos y controladores dentro de ella. Puede hacer que cualquier variable sea observable usando un simple ".obs".
 ```dart
 class Controller extends GetxController {
@@ -119,8 +97,7 @@ class Controller extends GetxController {
 }
 ```
-- Paso 3:
-  Cree su vista, use StatelessWidget y ahorre algo de RAM, con GetX ya no necesitará usar StatefulWidget.
+- Paso 3: Cree su vista, use StatelessWidget y ahorre algo de RAM, con GetX ya no necesitará usar StatefulWidget.
 ```dart
 class Home extends StatelessWidget {
@@ -483,21 +460,18 @@ void localLogWriter(String text, {bool isError = false}) {
 Amateur Coder hizo un video asombroso sobre utilidades, almacenamiento, enlaces y otras características! Link: [GetX Other Features](https://youtu.be/ttQtlX_Q0eU)
-# Rompiendo cambios desde 2.0
+# Cambios importantes desde 2.0
 1- Rx types:
-Antes: StringX ahora: RxString
-
-Antes: IntX ahora: RxInt
-
-Antes: MapX ahora: RxMap
-
-Antes: ListX ahora: RxList
-
-Antes: NumX ahora: RxNum
-
-Antes: RxDouble ahora: RxDouble
+| Antes   | Ahora      |
+| ------- | ---------- |
+| StringX | `RxString` |
+| IntX    | `RxInt`    |
+| MapX    | `RxMap`    |
+| ListX   | `RxList`   |
+| NumX    | `RxNum`    |
+| DoubleX | `RxDouble` |
 RxController y GetBuilder ahora se han fusionado, ya no necesita memorizar qué controlador desea usar, solo use GetXController, funcionará para gestión de estádo simple y también para reactivo.
@@ -553,3 +527,49 @@ GetMaterialApp(
 Si necesita contexto para encontrar un InheritedWidget, lo necesita en la vista o pasado por parámetro. En particular, encuentro esta solución muy fea, y para trabajar en equipo siempre tendremos una dependencia de la lógica de negocios de la vista. Getx no es ortodoxo con el enfoque estándar, y aunque no prohíbe completamente el uso de StatefulWidgets, InitState, etc., siempre tiene un enfoque similar que puede ser más limpio. Los controladores tienen ciclos de vida, y cuando necesita hacer una solicitud API REST, por ejemplo, no depende de nada en la vista. Puede usar onInit para iniciar la llamada http, y cuando lleguen los datos, se rellenarán las variables. Como GetX es completamente reactivo (realmente, y funciona bajo streams), una vez que se llenan los elementos, todos los widgets que usan esa variable se actualizarán automáticamente en la vista. Esto permite que las personas con experiencia en IU trabajen solo con widgets y no tengan que enviar nada a la lógica de negocios que no sean eventos de usuario (como hacer clic en un botón), mientras que las personas que trabajan con lógica de negocios podrán crearla y probarla por separado.
 Esta librería siempre se actualizará e implementará nuevas características. Siéntase libre de ofrecer PRs y contribuir a ellas.
+
+# Comunidad
+
+## Canales de la comunidad
+
+GetX tiene una comunidad muy activa e implicada. Si tiene dudas, o necesita cualquier tipo de asistencia sobre el uso de este framework, no dude en unirse a nuestr, tu duda será resuelta lo antes posible. Este repositorio es de uso exclusivo para abrir issues, pero siéntase libre de unirse a la Comunidad de GetX.
+
+
+| **Slack (🇬🇧)**                                                                                                                   | **Discord (🇬🇧 y 🇵🇹)**                                                                                                                 | **Telegram (🇵🇹)**                                                                                                          |
+| :-------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |
+| [![Get on Slack](https://img.shields.io/badge/slack-join-orange.svg)](https://communityinviter.com/apps/getxworkspace/getx) | [![Discord Shield](https://img.shields.io/discord/722900883784073290.svg?logo=discord)](https://discord.com/invite/9Hpt99N) | [![Telegram](https://img.shields.io/badge/chat-on%20Telegram-blue.svg)](https://t.me/joinchat/PhdbJRmsZNpAqSLJL6bH7g) |
+
+
+# Cómo contribuir
+
+_¿Quieres contribuir al proyecto? Estaremos orgullosos de destacarte como uno de nuestros colaboradores. Aquí hay algunos puntos en los que puede contribuir y hacer que GetX (y Flutter) sea aún mejor._
+
+- Ayudando a traducir el archivo Léame a otros idiomas.
+
+- Agregar documentación al archivo Léame (ni siquiera la mitad de las funciones de GetX han sido documentadas todavía).
+
+- Escriba artículos o haga videos que enseñen cómo usar GetX (se insertarán en el archivo Léame y en el futuro en nuestro Wiki).
+
+- Ofreciendo PRs para código/pruebas.
+
+- Incluyendo nuevas funciones.
+
+¡Cualquier contribución es bienvenida!
+
+## Artículos y vídeos (inglés)
+
+- [Flutter Getx EcoSystem package for arabic people](https://www.youtube.com/playlist?list=PLV1fXIAyjeuZ6M8m56zajMUwu4uE3-SL0) - Tutorial by [Pesa Coder](https://github.com/UsamaElgendy).
+- [Dynamic Themes in 3 lines using GetX™](https://medium.com/swlh/flutter-dynamic-themes-in-3-lines-c3b375f292e3) - Tutorial by [Rod Brown](https://github.com/RodBr).
+- [Complete GetX™ Navigation](https://www.youtube.com/watch?v=RaqPIoJSTtI) - Route management video by Amateur Coder.
+- [Complete GetX State Management](https://www.youtube.com/watch?v=CNpXbeI_slw) - State management video by Amateur Coder.
+- [GetX™ Other Features](https://youtu.be/ttQtlX_Q0eU) - Utils, storage, bindings and other features video by Amateur Coder.
+- [Firestore User with GetX | Todo App](https://www.youtube.com/watch?v=BiV0DcXgk58) - Video by Amateur Coder.
+- [Firebase Auth with GetX | Todo App](https://www.youtube.com/watch?v=-H-T_BSgfOE) - Video by Amateur Coder.
+- [The Flutter GetX™ Ecosystem ~ State Management](https://medium.com/flutter-community/the-flutter-getx-ecosystem-state-management-881c7235511d) - State management by [Aachman Garg](https://github.com/imaachman).
+- [The Flutter GetX™ Ecosystem ~ Dependency Injection](https://medium.com/flutter-community/the-flutter-getx-ecosystem-dependency-injection-8e763d0ec6b9) - Dependency Injection by [Aachman Garg](https://github.com/imaachman).
+- [GetX, the all-in-one Flutter package](https://www.youtube.com/watch?v=IYQgtu9TM74) - A brief tutorial covering State Management and Navigation by Thad Carnevalli.
+- [Build a To-do List App from scratch using Flutter and GetX](https://www.youtube.com/watch?v=EcnqFasHf18) - UI + State Management + Storage video by Thad Carnevalli.
+- [GetX Flutter Firebase Auth Example](https://medium.com/@jeffmcmorris/getx-flutter-firebase-auth-example-b383c1dd1de2) - Article by Jeff McMorris.
+- [Flutter State Management with GetX – Complete App](https://www.appwithflutter.com/flutter-state-management-with-getx/) - by App With Flutter.
+- [Flutter Routing with Animation using Get Package](https://www.appwithflutter.com/flutter-routing-using-get-package/) - by App With Flutter.
+- [A minimal example on dartpad](https://dartpad.dev/2b3d0d6f9d4e312c5fdbefc414c1727e?) - by [Roi Peker](https://github.com/roipeker)
--- a/lib/get_connect/connect.dart
View file @3880e00
+++ b/lib/get_connect/connect.dart
View file @3880e00
@@ -303,7 +303,7 @@ class GetConnect extends GetConnectInterface {
   }) async {
     try {
       final res = await post(
-        _concatUrl(url),
+        url,
         {'query': query, 'variables': variables},
         headers: headers,
       );
@@ -319,7 +319,7 @@ class GetConnect extends GetConnectInterface {
                     ))
                 .toList());
       }
-      return GraphQLResponse<T>(body: res.body['data'] as T?);
+      return GraphQLResponse<T>.fromResponse(res);
     } on Exception catch (_) {
       return GraphQLResponse<T>(graphQLErrors: [
         GraphQLError(
@@ -339,7 +339,7 @@ class GetConnect extends GetConnectInterface {
   }) async {
     try {
       final res = await post(
-        _concatUrl(url),
+        url,
         {'query': mutation, 'variables': variables},
         headers: headers,
       );
@@ -355,7 +355,7 @@ class GetConnect extends GetConnectInterface {
                     ))
                 .toList());
       }
-      return GraphQLResponse<T>(body: res.body['data'] as T?);
+      return GraphQLResponse<T>.fromResponse(res);
     } on Exception catch (_) {
       return GraphQLResponse<T>(graphQLErrors: [
         GraphQLError(
--- a/lib/get_connect/http/src/response/response.dart
View file @3880e00
+++ b/lib/get_connect/http/src/response/response.dart
View file @3880e00
@@ -7,6 +7,16 @@ import '../status/http_status.dart';
 class GraphQLResponse<T> extends Response<T> {
   final List<GraphQLError>? graphQLErrors;
   GraphQLResponse({T? body, this.graphQLErrors}) : super(body: body);
+  GraphQLResponse.fromResponse(Response res)
+      : graphQLErrors = null,
+        super(
+            request: res.request,
+            statusCode: res.statusCode,
+            bodyBytes: res.bodyBytes,
+            bodyString: res.bodyString,
+            statusText: res.statusText,
+            headers: res.headers,
+            body: res.body['data'] as T?);
 }
 class Response<T> {
@@ -60,7 +70,8 @@ class Response<T> {
   final T? body;
 }
-Future<String> bodyBytesToString(Stream<List<int>> bodyBytes, Map<String, String> headers) {
+Future<String> bodyBytesToString(
+    Stream<List<int>> bodyBytes, Map<String, String> headers) {
   return bodyBytes.bytesToString(_encodingForHeaders(headers));
 }
@@ -101,7 +112,9 @@ class HeaderValue {
   }
   static HeaderValue parse(String value,
-      {String parameterSeparator = ';', String? valueSeparator, bool preserveBackslash = false}) {
+      {String parameterSeparator = ';',
+      String? valueSeparator,
+      bool preserveBackslash = false}) {
     var result = HeaderValue();
     result._parse(value, parameterSeparator, valueSeparator, preserveBackslash);
     return result;
@@ -131,7 +144,8 @@ class HeaderValue {
     return stringBuffer.toString();
   }
-  void _parse(String value, String parameterSeparator, String? valueSeparator, bool preserveBackslash) {
+  void _parse(String value, String parameterSeparator, String? valueSeparator,
+      bool preserveBackslash) {
     var index = 0;
     bool done() => index == value.length;
--- a/lib/get_navigation/src/extension_navigation.dart
View file @3880e00
+++ b/lib/get_navigation/src/extension_navigation.dart
View file @3880e00
@@ -283,8 +283,10 @@ extension ExtensionDialog on GetInterface {
   /// Custom UI Dialog.
   Future<T?> defaultDialog<T>({
     String title = "Alert",
+    EdgeInsetsGeometry? titlePadding,
     TextStyle? titleStyle,
     Widget? content,
+    EdgeInsetsGeometry? contentPadding,
     VoidCallback? onConfirm,
     VoidCallback? onCancel,
     VoidCallback? onCustom,
@@ -361,8 +363,8 @@ extension ExtensionDialog on GetInterface {
     }
     Widget baseAlertDialog = AlertDialog(
-      titlePadding: EdgeInsets.all(8),
-      contentPadding: EdgeInsets.all(8),
+      titlePadding: titlePadding ?? EdgeInsets.all(8),
+      contentPadding: contentPadding ?? EdgeInsets.all(8),
       backgroundColor: backgroundColor ?? theme.dialogBackgroundColor,
       shape: RoundedRectangleBorder(