๐ŸŽ‰ Nylo v7 ์ถœ์‹œ! ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ ๋ณด๊ธฐ โ†’

Nylo Website logo

Flutter
๋งˆ์ดํฌ๋กœ ํ”„๋ ˆ์ž„์›Œํฌ
ํ˜„๋Œ€์ ์ธ ์•ฑ์„ ์œ„ํ•œ

Flutter ์•ฑ์„ ๊ตฌ์ถ•ํ•˜๊ธฐ ์œ„ํ•œ ๊ฒฌ๊ณ ํ•œ ๊ธฐ๋ฐ˜. ๋ผ์šฐํŒ…, ์ƒํƒœ ๊ด€๋ฆฌ, ๋„คํŠธ์›Œํ‚น ๋“ฑ ๋ชจ๋“  ๊ฒƒ์ด ํ•˜๋‚˜์˜ ์šฐ์•„ํ•œ ํŒจํ‚ค์ง€์—.

์‹œ์ž‘ํ•˜๊ธฐ
์‚ดํŽด๋ณด๊ธฐ
๊ธฐ๋Šฅ

๊ตฌ์ถ•์— ํ•„์š”ํ•œ ๋ชจ๋“  ๊ฒƒ

Nylo๋Š” ํ”„๋กœ๋•์…˜ ์ˆ˜์ค€์˜ Flutter ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ž์‹  ์žˆ๊ฒŒ ๋งŒ๋“œ๋Š” ๋ฐ ํ•„์š”ํ•œ ๋ชจ๋“  ๋„๊ตฌ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

Metro CLI

ํ„ฐ๋ฏธ๋„์—์„œ ๋ฌด์—‡์ด๋“  ์ƒ์„ฑ

Metro๋Š” ๋‹จ์ผ ๋ช…๋ น์œผ๋กœ ํŽ˜์ด์ง€, ๋ชจ๋ธ, ์ปจํŠธ๋กค๋Ÿฌ, ์œ„์ ฏ ๋“ฑ์„ ์Šค์บํด๋”ฉํ•˜๋Š” Nylo์˜ CLI ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

Metro์— ๋Œ€ํ•ด ๋” ์•Œ์•„๋ณด๊ธฐ
metro make:page HomePage
# Creates a new page called HomePage

metro make:api_service User
# Creates a new API Service called UserApiService

metro make:model User
# Creates a new model called User

metro make:stateful_widget FavouriteWidget
# Creates a new stateful widget called FavouriteWidget
class ApiService extends NyApiService {
  @override
  String get baseUrl => "https://api.example.com/v1";

  Future<List<Post>> posts() async {
    return await network(
      request: (request) => request.get("/posts"),
    );
  }
}

// Usage in your page
final posts = await api<ApiService>((request) => request.posts());
๋„คํŠธ์›Œํ‚น

๊ฐ„ํŽธํ•œ API ํ†ตํ•ฉ

์ž๋™ JSON ํŒŒ์‹ฑ, ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ, ์š”์ฒญ ์ธํ„ฐ์…‰ํ„ฐ๋ฅผ ๊ฐ–์ถ˜ ๊น”๋”ํ•˜๊ณ  ์œ ์ง€๋ณด์ˆ˜ ๊ฐ€๋Šฅํ•œ API ์„œ๋น„์Šค๋ฅผ ์ž‘์„ฑํ•˜์„ธ์š”.

๋„คํŠธ์›Œํ‚น์— ๋Œ€ํ•ด ๋” ์•Œ์•„๋ณด๊ธฐ
์‚ดํŽด๋ณด๊ธฐ

์ œ์ž‘์„ ์œ„ํ•œ ๊ฐ•๋ ฅํ•œ ๋„๊ตฌ

๋‹ค์Œ Flutter ์•ฑ์„ ๊ตฌ์ถ•ํ•˜๋Š” ๋ฐ ํ•„์š”ํ•œ ๋ชจ๋“  ๊ฒƒ

routes/router.dart
appRouter() => nyRoutes((router) {
    router.add(HomePage.path).initialRoute();

    router.add(DiscoverPage.path);

    router.add(LoginPage.path, 
        transitionType: TransitionType.bottomToTop());

    router.add(ProfilePage.path,
        routeGuard: [
            AuthGuard()
        ]
    );
});

Flutter ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์œ„ํ•œ ๋ณต์žกํ•œ ๋ผ์šฐํŠธ, ์ธํ„ฐํŽ˜์ด์Šค ๋ฐ UI ํŽ˜์ด์ง€๋ฅผ ๊ตฌ์ถ•ํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

์‚ฌ์šฉ์ž ์ธ์ฆ

String userToken = "eyJhbG123...";

await Auth.authenticate(data: {"token": userToken});
๋‹จ๊ณ„ 2

์ด์ œ ์‚ฌ์šฉ์ž๊ฐ€ ์•ฑ์„ ์—ด๋ฉด ์ธ์ฆ๋ฉ๋‹ˆ๋‹ค.

final userData = Auth.data();
// {"token": "eyJhbG123..."}

bool isAuthenticated = await Auth.isAuthenticated();
// true
๋‹จ๊ณ„ 3

๋ผ์šฐํ„ฐ์— authenticatedRoute๋ฅผ ์„ค์ •ํ–ˆ๋‹ค๋ฉด, ์‚ฌ์šฉ์ž๊ฐ€ ์•ฑ์„ ๋‹ค์‹œ ์—ด ๋•Œ ์ด ํŽ˜์ด์ง€๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.

routes/router.dart
appRouter() => nyRoutes((router) {
    ...
    router.add(LandingPage.path).initialRoute();

    router.add(DashboardPage.path).authenticatedRoute();
    // overrides the initial route when a user is authenticated

์‚ฌ์šฉ์ž ๋กœ๊ทธ์•„์›ƒ

await Auth.logout();

Flutter ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ์‚ฌ์šฉ์ž๋ฅผ ์ธ์ฆํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

ํผ ์ƒ์„ฑ

terminal
metro make:form RegisterForm
๋‹จ๊ณ„ 2

ํผ ์ˆ˜์ •

app/forms/register_form.dart
class RegisterForm extends NyFormWidget {

    RegisterForm({super.key, super.submitButton, super.onSubmit, super.onFailure});

    // Add your fields here
    @override
    fields() => [
        Field.capitalizeWords("name",
            label: "Name",
            validator: FormValidator.notEmpty(),
        ),
        Field.email("email_address",
            label: "Email",
            validator: FormValidator.email()
        ),
        Field.password("password",
            label: "Password",
            validator: FormValidator.password(),
        ),
    ];

    static NyFormActions get actions => const NyFormActions("RegisterForm");
}
๋‹จ๊ณ„ 3

์œ„์ ฏ์—์„œ ํผ ์‚ฌ์šฉ

register_page.dart
@override
Widget build(BuildContext context) {
  return Scaffold(
    body: RegisterForm(
      submitButton: Button.primary(text: "Submit"),
      onSubmit: (data) {
        printInfo(data);
      },
    ),
  );
}

Nylo ํผ์œผ๋กœ ํ•œ ๊ณณ์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ๊ด€๋ฆฌ, ๊ฒ€์ฆ, ์ œ์ถœํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

์ƒํƒœ ๊ด€๋ฆฌ ์œ„์ ฏ ์ƒ์„ฑ

terminal
metro make:stateful_widget CartIcon
resources/cart_icon_widget.dart
class _CartIconState extends NyState<CartIcon> {
  ...

  @override
  Map<String, Function> get stateActions => {
    "clear_cart": () {
      _items = 0;
    },
    ...
  };

  @override
  Widget view(BuildContext context) {
    return Container(child: Text("Items in cart: ${_items}"));
  }
}
๋‹จ๊ณ„ 2

Use CartIcon.action("clear_cart")

another widget
Button.primary(text: "Add to cart",
    onPressed: () {
      CartIcon.action("clear_cart");
    }
)

Flutter ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ์œ„์ ฏ์„ ์œ„ํ•œ ๊ฐ•๋ ฅํ•œ ์ƒํƒœ ๊ด€๋ฆฌ.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

์ด๋ฒคํŠธ ์ƒ์„ฑ

terminal
metro make:event Logout
app/events/logout_event.dart
class LogoutEvent implements NyEvent {
    @override
    final listeners = {
        DefaultListener: DefaultListener(),
    };
}

class DefaultListener extends NyListener {
    @override
    handle(dynamic event) async {

        // logout user
        await Auth.logout();

        // redirect to home page
        routeTo(HomePage.path,
            navigationType: NavigationType.pushAndForgetAll
        );
    }
}
๋‹จ๊ณ„ 2

์ด๋ฒคํŠธ ๋ฐœํ–‰

MaterialButton(child: Text("Logout"),
    onPressed: () {
        event<LogoutEvent>();
    },
)

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ์ด๋ฒคํŠธ๋ฅผ ๋ฐœํ–‰ํ•˜๊ณ  ์ˆ˜์‹ ํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ

์ž‘์—…์„ ํ•œ ๋ฒˆ ์‹คํ–‰ํ•˜๋„๋ก ์˜ˆ์•ฝ

Nylo.scheduleOnce("onboarding_info", () {
    print("Perform code here to run once");
});

ํŠน์ • ๋‚ ์งœ ์ดํ›„์— ์ž‘์—…์„ ํ•œ ๋ฒˆ ์‹คํ–‰ํ•˜๋„๋ก ์˜ˆ์•ฝ

Nylo.scheduleOnceAfterDate("app_review_rating", () {
    print("Perform code to run once after DateTime(2025, 04, 10)");
}, date: DateTime(2025, 04, 10));

์ž‘์—…์„ ๋งค์ผ ํ•œ ๋ฒˆ ์‹คํ–‰ํ•˜๋„๋ก ์˜ˆ์•ฝ

Nylo.scheduleOnceDaily("free_daily_coins", () {
    print("Perform code to run once daily");
});

Flutter ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ์ž‘์—…์„ ํ•œ ๋ฒˆ ๋˜๋Š” ๋งค์ผ ์‹คํ–‰ํ•˜๋„๋ก ์˜ˆ์•ฝํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

API ์„œ๋น„์Šค ์ƒ์„ฑ

terminal
metro make:api_service User
app/networking/user_api_service.dart
class UserApiService extends NyApiService {
    @override
    String get baseUrl => getEnv("API_BASE_URL");

    Future<User?> fetchUser(int id) async {
        return await get<User>(
            "/users/$id",
            queryParameters: {"include": "profile"},
        );
    }

    Future<User?> createUser(Map<String, dynamic> data) async {
        return await post<User>("/users", data: data);
    }
}
๋‹จ๊ณ„ 2

ํŽ˜์ด์ง€์—์„œ API ํ˜ธ์ถœ

User? user = await api<UserApiService>(
    (request) => request.fetchUser(1),
);

์ž๋™ JSON ํŒŒ์‹ฑ, ์บ์‹ฑ, ์ธํ„ฐ์…‰ํ„ฐ๋ฅผ ๊ฐ–์ถ˜ ์šฐ์•„ํ•œ API ์„œ๋น„์Šค.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

๋ฐ์ดํ„ฐ๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ์ €์žฅ

saving_data.dart
// Save values to secure storage
await NyStorage.save("coins", 100);
await NyStorage.save("username", "Anthony");
await NyStorage.save("isPremium", true);

// Save with TTL (auto-expires)
await NyStorage.save("session", "abc123",
    expiry: Duration(hours: 1),
);
๋‹จ๊ณ„ 2

ํƒ€์ž… ์บ์ŠคํŒ…์œผ๋กœ ์ฝ๊ธฐ

// Automatic type casting
String? username = await NyStorage.read("username");
int? coins = await NyStorage.read<int>("coins");
bool? isPremium = await NyStorage.read<bool>("isPremium");

// Delete a value
await NyStorage.delete("coins");

ํƒ€์ž… ์บ์ŠคํŒ…, TTL ๋งŒ๋ฃŒ, ์ปฌ๋ ‰์…˜์„ ๊ฐ–์ถ˜ ์•ˆ์ „ํ•œ ๋กœ์ปฌ ์Šคํ† ๋ฆฌ์ง€.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

์–ธ์–ด ํŒŒ์ผ ์ถ”๊ฐ€

lang/en.json
{
    "welcome": "Welcome",
    "greeting": "Hello {{name}}",
    "navigation": {
        "home": "Home",
        "profile": "Profile"
    }
}
๋‹จ๊ณ„ 2

์œ„์ ฏ์—์„œ ํ…์ŠคํŠธ ๋ฒˆ์—ญ

// Simple translation
Text("welcome".tr())  // "Welcome"

// With arguments
Text("greeting".tr(arguments: {"name": "Anthony"}))
// "Hello Anthony"

// Nested keys
Text("navigation.home".tr())  // "Home"

JSON ํŒŒ์ผ, ์ธ์ˆ˜, RTL์„ ์ง€์›ํ•˜๋Š” ๋‹ค๊ตญ์–ด ์ง€์›.

๋” ์•Œ์•„๋ณด๊ธฐ
๋‹จ๊ณ„ 1

๋‚ด๋น„๊ฒŒ์ด์…˜ ํ—ˆ๋ธŒ ์ƒ์„ฑ

terminal
metro make:navigation_hub base
resources/pages/base_navigation_hub.dart
class _BaseNavigationHubState extends NavigationHub<BaseNavigationHub> {

    NavigationHubLayout? layout = NavigationHubLayout.bottomNav();

    @override
    bool get maintainState => true;

    _BaseNavigationHubState() : super(() async {
        return {
            0: NavigationTab(
                title: "Home",
                page: HomeTab(),
                icon: Icon(Icons.home),
            ),
            1: NavigationTab(
                title: "Settings",
                page: SettingsTab(),
                icon: Icon(Icons.settings),
            ),
        };
    });
}
๋‹จ๊ณ„ 2

๋ ˆ์ด์•„์›ƒ์„ ์‰ฝ๊ฒŒ ์ „ํ™˜

// Bottom navigation
NavigationHubLayout.bottomNav()

// Top navigation
NavigationHubLayout.topNav()

// Journey / wizard flow
NavigationHubLayout.journey()

์ƒํƒœ ์œ ์ง€์™€ ํ•จ๊ป˜ ํ•˜๋‹จ ๋‚ด๋น„๊ฒŒ์ด์…˜, ์ƒ๋‹จ ๋‚ด๋น„๊ฒŒ์ด์…˜ ๋˜๋Š” ์—ฌ์ • ํ๋ฆ„์„ ๊ตฌ์ถ•ํ•˜์„ธ์š”.

๋” ์•Œ์•„๋ณด๊ธฐ

์ปค๋ฎค๋‹ˆํ‹ฐ์˜ ์‚ฌ๋ž‘์„ ๋ฐ›๋Š”

๊ฐœ๋ฐœ์ž๋“ค์ด ๋งํ•˜๋Š” Nylo Website

ํ† ๋ก ์— ์ฐธ์—ฌํ•˜๊ธฐ

I'm new to Dart and new to your framework (which I love)

Peter Senior Director of Heroku Global

I wanted to thank you guys for the great job you are doing.

@youssefKadaouiAbbassi

Just to say that I am in love with @nylo_dev's website!! Definitely gonna explore it!

@esfoliante_txt

Really love the concept of this framework

@Chrisvidal

Nylo is the best framework for flutter, which makes developing easy

@higakijin

This is incredible. Very well done!

FireflyDaniel

Very nice Framework! Thank you so much!

@ChaoChao2509

I just discovered this framework and I'm very impressed. Thank you

@lepresk

Great work on Nylo

@dylandamsma

This is by far the best framework out there. Amazing quality and features. Thanks so much.

@2kulfi

It's interesting and very amazing. It makes the work more easier and less time consuming. Great work. Thank you

darkreader01

Salut. Je viens juste de dรฉcouvrir votre outils et je le trouve vraiment super. Une belle dรฉcouverte pour moi ๐Ÿ‘Œ๐ŸคŒ

ojean-01