JulioCGMC / google_translator

BSD 3-Clause "New" or "Revised" License
2 stars 6 forks source link
dart flutter package

google_translator

pub package

A flutter plugin for adapting screen and font size.Let your UI display a reasonable layout on different screen sizes!

Usage:

Get the Google Translation Api key:

Add dependency:

Please check the latest version before installation. If there is any problem with the new version, please use the previous version

dependencies:
  # Functionalities
  google_translator: ^{latest version}
  ..
  flutter:
    sdk: flutter

Add the following imports to your Dart code:

import 'package:google_translator/google_translator.dart';

Getting Started

First, you will need to send the API Key, allong with a few default parameters described bellow, before the calling of the translate function (we recomend to do as in the example):

void main() {
    /// Required to make the `GoogleTranslatorInit` call before the `MaterialApp`
    WidgetsFlutterBinding.ensureInitialized();
    runApp(MyApp());
}

class MyApp extends StatelessWidget {

  final String apiKey = "YOUR_GCP_API_KEY";

  @override
  Widget build(BuildContext context) {
    return GoogleTranslatorInit(apiKey,
      translateFrom: Locale('pt-br'),
      translateTo: Locale('en'),
      // automaticDetection: , In case you don't know the user language will want to traslate,
      // cacheDuration: Duration(days: 13), The duration of the cache translation.
      builder: () => MaterialApp(
        title: 'Flutter Demo',
        theme: ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: MyHomePage(title: 'Página inicial de demonstração do Flutter'),
      ),
    );
  }
}

Note: If will want to make the call before the MaterialApp, will have to add the WidgetsFlutterBinding.ensureInitialized(); before the runApp function.


Basic Usage

Now, all you'll have to make is add the .translate() to all the Text you want to translate.

Scaffold(
    appBar: AppBar(
    title: Text(widget.title ?? "").translate(),
    ),
    body: Column(
        children: [
            Text("Meu texto traduzido").translate(),
            Text("Este texto mostra um placeholder diferente").translate("Place to Holder")
        ]
    ),
);

Todo:

Disclaimer

This package works with cache data dio_http_cache, that, by default last's 7 days, but can be change in the GoogleTranslatorInit > cacheDuration parameter.

Issues

Please if you see any issues, bugs, or feature requests, send to me in: GitHub issue.