mirror of
https://github.com/vector-im/element-ios.git
synced 2024-09-30 16:22:39 +00:00
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
The `buildable` folder contains templates with source files that build.
|
|
|
|
The goal is to turn these templates as Xcode templates. They are part of the Riot project in order to ensure they build
|
|
|
|
# ScreenTemplate
|
|
This is the boilerplate to create a screen that follows the MVVM-C pattern used within the Element app.
|
|
|
|
To create a screen from this template (before it becomes an Xcode template):
|
|
|
|
- `./createScreen.sh ScreenFolder MyScreenName`
|
|
- Import the created folder in the Xcode project
|
|
|
|
This will create ScreenFolder within the Riot/Modules. Files inside will be named `MyScreenNameXxx`.
|
|
|
|
|
|
# SimpleScreenTemplate
|
|
This is the boilerplate to create a simple screen.
|
|
|
|
To create a screen from this template (before it becomes an Xcode template):
|
|
|
|
- `./createSimpleScreen.sh ScreenFolder MyScreenName`
|
|
- Import the created folder in the Xcode project
|
|
|
|
This will create ScreenFolder within the Riot/Modules. Files inside will be named `MyScreenNameXxx`.
|
|
|
|
|
|
# FlowCoordinatorTemplate
|
|
The boilerplate to create a root coordinator and its presenter bridge that can be used from Objective-C.
|
|
|
|
To use it (before it becomes an Xcode template):
|
|
|
|
- `./createRootCoordinator.sh Folder MyRootCoordinatorName [DefaultScreenName]`
|
|
- Import created files in the Xcode project
|
|
|
|
|
|
# Usage example
|
|
Following commands:
|
|
|
|
```
|
|
./createScreen.sh MyFlowDir/MyFirstScreenDir MyFirstScreen
|
|
./createRootCoordinator.sh MyFlowDir MyFlow MyFirstScreen
|
|
```
|
|
|
|
generate in `Riot/Modules`:
|
|
|
|
```
|
|
Riot/Modules/MyFlowDir
|
|
├── MyFirstScreenDir
|
|
│ ├── MyFirstScreenCoordinator.swift
|
|
│ ├── MyFirstScreenCoordinatorType.swift
|
|
│ ├── MyFirstScreenViewAction.swift
|
|
│ ├── MyFirstScreenViewController.storyboard
|
|
│ ├── MyFirstScreenViewController.swift
|
|
│ ├── MyFirstScreenViewModel.swift
|
|
│ ├── MyFirstScreenViewModelType.swift
|
|
│ └── MyFirstScreenViewState.swift
|
|
├── MyFlowCoordinator.swift
|
|
├── MyFlowCoordinatorBridgePresenter.swift
|
|
└── MyFlowCoordinatorType.swift
|
|
```
|
|
|
|
The generated code is ready to use. The screen provided by `ScreenTemplate` can by displayed by:
|
|
|
|
```
|
|
MyFlowCoordinatorBridgePresenter *presenter = [[MyFlowCoordinatorBridgePresenter alloc] initWithSession:session];
|
|
[presenter presentFrom:self animated:YES];
|
|
```
|