SCddu/flutter-in-practice

This project can be used as a starter for flutter app development, including a demo app for learning flutter components and a social video app named weiguan which is similar to TikTok.

Flutter in Practice

This project can be used as a starter for flutter app development, including a demo app for learning flutter components and a social video app named weiguan which is similar to TikTok. There is also an article Flutter 移动应用开发指南 for learning this project.

To students of course: 最新的实战项目目录结构已按照新版 干净架构最佳实践 进行了重构，目录结构调整较大。如想获取之前版本，可查看提交记录。

Dependent frameworks and packages

1. Flutter
2. cached_network_image
3. carousel_slider
4. cookie_jar
5. dio
6. flutter_redux
7. functional_data
8. image_picker
9. injector
10. json_annotation
11. logging
12. meta
13. package_info
14. provider
15. redux
16. redux_logging
17. redux_persist
18. redux_persist_flutter
19. redux_thunk
20. video_player
21. build_runner
22. flutter_launcher_icons
23. functional_data_generator
24. json_serializable

How to run

Install flutter sdk

Please refer to flutter official document Install.

Clone repository

git clone git@github.com:jaggerwang/flutter-in-practice.git && cd flutter-in-practice

Install dependent packages

flutter packages get

Connect a device or run a simulator

Connet your Android or iOS device to your computer or run a simulator using the following commands.

$ flutter emulators
2 available emulators:

9.0-1080p           • 9.0-1080p     • Google • android
apple_ios_simulator • iOS Simulator • Apple  • ios

...
$ flutter emulators --launch apple_ios_simulator

Run Flutter Demo

flutter run -t lib/demo/main.dart

Run Weiguan APP

flutter run -t lib/weiguan/mobile/main.dart

Weiguan app needs a api service to get and post data. It use mock apis by default, but you can configure it to use a real REST or GraphQL api service. For development purpose, you should configure and run main file main_dev.dart.

Use Sanic in Practice REST api service.

  final container = WgContainer(WgConfig(
    enableRestApi: true,
    apiBaseUrl: 'http://localhost:8000',
  ));

Use Spring Boot in Practice REST api service.

  final container = WgContainer(WgConfig(
    enableRestApi: true,
    apiBaseUrl: 'http://localhost:8080',
  ));

Use Spring Boot in Practice GraphQL api service.

  final container = WgContainer(WgConfig(
    enableGraphQLApi: true,
    apiBaseUrl: 'http://localhost:8080',
  ));

Use Spring Cloud in Practice GraphQL api service.

This api service only support GraphQL protocol, and it uses OAuth2 login. You should change the ports in the following steps if you run this api service by docker compose.

First you need create a client for this app.

hydra --endpoint 'http://localhost:4445/' clients create --id fip --name 'Flutter in Practice' --grant-types authorization_code,refresh_token --response-types token,code --scope offline,user,post,file,stat --token-endpoint-auth-method none --callbacks 'net.jaggerwang.fip:/login/oauth2/code/hydra'

Then configure as following:

  final container = WgContainer(WgConfig(
    enableGraphQLApi: true,
    apiBaseUrl: 'http://localhost:8080',
    enableOAuth2Login: true,
    oAuth2Config: OAuth2Config(
      clientId: 'fip',
      redirectUrl: 'net.jaggerwang.fip:/login/oauth2/code/hydra',
      authorizationEndpoint: 'http://localhost:4444/oauth2/auth',
      tokenEndpoint: 'http://localhost:4444/oauth2/token',
      scopes: ['offline', 'user', 'post', 'file', 'stat'],
    ),
  ));

The video player can not work on iOS simulator, you should use an Android emulator or a real device.

Screenshots