Android Studio 나 IntelliJ를 설치하여 plantUML plugin 을 설치하면 편집이 세상쉽다.
작업중인 프로젝트의 테스트가 제대로 작성되어 있는지를 검사하여 % 로 결과를 보여주는 툴이다.
grale.build.kts파일에 다음을 추가한다.
plugins {
jacoco
}
jacoco {
toolVersion = "0.8.5"
}
테스트에 대한 커버리지 검사결과를 html,xml,csv형태로 만들어서 주기위해서 태스크를 추가한다.
task("jacocoTestReport", JacocoReport::class) {
dependsOn("testDebugUnitTest")
reports {
xml.isEnabled = true
csv.isEnabled = false
html.isEnabled = false
}
sourceDirectories.setFrom("${projectDir}/src/main/java")
classDirectories.setFrom("${buildDir}/tmp/kotlin-classes/debug")
executionData.setFrom(files("${buildDir}/jacoco/testDebugUnitTest.exec"))
}
그밖의 https://qiita.com/beyondseeker/items/907e20a4da7d46c9de57
를 참고.
여러모듈일 경우 모듈별 결과를 merge태스트를 통해서 합할수도있다.
https://subroh0508.net/articles/jacoco-scripts-in-anroid-muitl-module-project-by-kotlin-dsl
Github 등에 코드를 전송하여 CI툴을 연계시에 자주실수하는 기계적인 코드규칙에 대한 검사(LINT)를 수행할수 있도록 도와주는 프로그램이다.
주로 PR(Pull Request)할때에 발생하기 쉬운 문법적오류 등의 검사를 자동으로 해주는 툴이다.
사용법은 Danger가 설치된 로컬 또는 CI상에서 동작하며, danger 프로그램을 설치해야한다.
설치는 간단하다.
gem install danger
gem install danger_checkstyle_format ( 이것은 Danger plugin https://github.com/noboru-i/danger-checkstyle_format)
사용법은
danger --verbose --new-comment -dangerfile=./프로그램소스내에서 별도로 작성한 Danger파일
하면 작동한다.
아래는 예제이다.
# プルリクが編集中
warn("このプルリクが編集中のようです。") if github.pr_title.include? "[WIP]"
# プルリクがでかすぎる
warn("プルリクの変更箇所が多すぎるので分割しましょう。") if git.lines_of_code > 500
# マージコミットがある
#has_merge_commit = git.commits.any? { |c| c.message =~ /^Merge branch '#{github.branch_for_base}'/ }
#fail "マージコミットがあるのでリベースしましょう。" unless has_merge_commit
# マイルストーンが設定されていない
has_milestone = github.pr_json["milestone"] != nil
warn("プルリクにマイルストーンが設定されていないようです。", sticky: false) unless has_milestone
# 誰もアサインされていない
has_assignee = github.pr_json["assignee"] != nil
warn("誰もアサインされていないようです。", sticky: false) unless has_assignee
Bitrise를 연동한다면, Bitrise에서 script를 추가한후에
gem install danger
gem install danger-checkstyle_format
gem install danger-android_lint
danger --verbose --new-comment --dangerfile=./androidApp/LintDangerFile
을 추가한다.
Bitrise에서 Danger 를 github와 연계하려면 Env var에 DANGER_GITHUB_API_TOKEN 를 추가하여 값에 git token값을 입력하면된다.
danger-checkstyle_format 플러그인을 이용한다면,
1 . Bitrise의 workflow에 Gradle Task추가. ( 예로. :androidApp:check)
2 . Env var에 GRADLEW_PATH = ./gradlew 로 값추가.
3 . Bitrise의 workflow에 script추가하여 위에서 설명한 danger설치등…
checkstyle_format.base_path = Dir.pwd
checkstyle_format.report "./androidApp/build/reports/ktlint-results.xml"
#(ktlint-results.xml이 필요하니까 Lint다음에 진행하도록한다)
# ktlint 시에 결과파일이 저기에 출력되도록 해둬야한다.
예:
val ktlintCheckANdroid by tasks.creating(JavaExec::class) {
...
args = listOf(
"--reporter=plain",
"--reporter=checkstyle,output=${buildDir}/reports/ktlint-results.xml",
"src/**/*.kt"
)...
}
설정이 제대로 되었다면
cocos2dx 4.0 을 다운받았으면,
프로젝트를 생성하고 프로젝트폴더밑에 iosProject 라는 대충 폴더 만들고 아래를 실행해서 xocde용 프로젝트 파일을 만들어야한다.
cmake … -GXcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphoneos
xxx. xcodeproj 을 실행하고 빌드해보면 안된다.
유저폴더에 libiconv.dylib 얘랑 다른 뭐랑 없단다.
컴퓨터에 있는 파일이다. 찾자.
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS.simruntime/Contents/Resources/RuntimeRoot/usr/lib/libiconv.dylib
에있다.
xcode의 project->build settings -> linking -> other link flag 를 보면 debug 항목이 있는데 클릭하면 맨밑에 에러난 두개(?
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS.simruntime/Contents/Resources/RuntimeRoot/usr/lib/libz.dylib
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS.simruntime/Contents/Resources/RuntimeRoot/usr/lib/libiconv.dylib) 파일이 보인다.
이 경로를 위의 경로로 바꿔치기한다.
Di (Dependense Injection) するためにはDagger2, HiltがあるがKotlinらしくなくて使い方がやや口説くなることがあったのでIntelliJ社はKotlin専用のDIライブラリのKoinを作った。
KoinはKotlinらしく使いやすい、簡単なのでDIなんかを初めて触った素人も即座で使える。
早速やって見よう。
// Add Maven Central to your repositories if needed
repositories {
mavenCentral()
}
dependencies {
// Koin for Android
compile "org.koin:koin-android:$koin_version"
// Testing
testCompile "org.koin:koin-test:$koin_version"
}
def koin_version = "2.1.5"
// For Android
// Koin for Android
implementation "org.koin:koin-android:$koin_version"
// Koin Android Scope features
implementation "org.koin:koin-android-scope:$koin_version"
// Koin Android ViewModel features
implementation "org.koin:koin-android-viewmodel:$koin_version"
// Koin Android Experimental features
implementation "org.koin:koin-android-ext:$koin_version"
testImplementation "org.koin:koin-test:$koin_version"
// For AndroidX
// Koin AndroidX Scope features
implementation "org.koin:koin-androidx-scope:$koin_version"
// Koin AndroidX ViewModel features
implementation "org.koin:koin-androidx-viewmodel:$koin_version"
// Koin AndroidX Fragment features
implementation "org.koin:koin-androidx-fragment:$koin_version"
// Koin AndroidX Experimental features
implementation "org.koin:koin-androidx-ext:$koin_version"
//-----------------------//
// package name/domain/entity/Article.kt
//-----------------------//
data class Article(
var say : String = "",
)
//-----------------------//
// package name/domain/usecase/MyUseCase.kt
//-----------------------//
class MyUseCase (
private val localRepository: LocalRepository
) {
fun sayHelloMessageShowUseCase() : String {
return localRepository.getHelloMsg()
}
}
//-----------------------//
// package name/domain/repository/LocalRepository.kt
//-----------------------//
class LocalRepository(
private val databaseModule: DatabaseModule
)
{
fun getHelloMsg() = databaseModule.getDashboard().say
}
//-----------------------//
// package name/di/DatabaseModule/DatabaseModule.kt
//-----------------------//
class DatabaseModule(
val article: Article
) {
fun getDashboard() : Article {
article.say = "Say Hello Koin"
return article
}
}
class App : Application() {
override fun onCreate() {
super.onCreate()
startKoin {
androidContext(this@App)
modules(module {
factory { Article() }
single { DatabaseModule(get()) }
single { LocalRepository(get()) }
factory { DashboardUsecase(get()) }
viewModel { DashboardViewModel() }
})
}
}
}
普通はのInjectしたいとことにKoinComponentを継承すればできるはず。
//-----------------------//
// package name/ui/dashboard/DashboardViewModel.kt
//-----------------------//
class DashboardViewModel : ViewModel(), KoinComponent {
private val usecase: sayHelloMessageShowUseCase by inject()
private val _text = MutableLiveData<String>().apply {
value = "This is dash Fragment"
}
val text: LiveData<String> = _text
fun change() {
_text.postValue(usecase.changeText())
}
}
//-----------------------//
// package name/ui/dashboard/DashboardFragment.kt
//-----------------------//
class DashboardFragment : Fragment(), KoinComponent {
val dashboardViewModel: DashboardViewModel by viewModel()
lateinit var textView: TextView
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
val root = inflater.inflate(R.layout.fragment_dashboard, container, false)
textView = root.findViewById(R.id.text_dashboard)
dashboardViewModel.text.observe(viewLifecycleOwner, Observer {
textView.text = it
})
textView.setOnClickListener {
dashboardViewModel.change()
}
return root
}
class SampleKoinTest : KoinTest {
private val usecase: DashboardUsecase by inject<DashboardUsecase>()
@get:Rule
val koinTestRule = KoinTestRule.create {
modules(AppModules().modules)
}
@Test
fun sampleTest() {
assert("Say Hello Koin" == usecase.changeText())
}
}
これは。。これは。。素晴らしいすぎる。
どんどんIntellJ社に支配されている感じがする。怖っ。。
KoinはLight weight DI ライブラリーなのでDaggerより多少の機能が足りないかもしれないがこれて十分だ。
Dagger から Hilt, Koinに 引越しする前に覚えたことを忘れないうちに書いておきたいと思ってここに書き留める。
参考：DIというのは。
DIは外部から機能を注入することでなるべくインスタンスを生成しないようにするのが基本概念だ。
DIを使わないとインタフェースを使って同じく実現できるがそんなことしようとすると作るファイル数が増えるのでめんどくさくなるので普通はDIライブラリーを使う。
プログラミングにてDIの仕組みは外部に自分が定義したモジュール単位のクラスを使いたいインスタンス変数にタイプを合わせて注入して使うことだ。
作ったモジュールがインスタンス変数に注入されるのはDIライブラリーがやってくれるので指定だけやればDIが実現できる。
Android には Dagger, Hilt, Koin などが普通。
Daggerから DI をするためには以下の概念を理解する必要がある。
Dagger はAndroid専用のライブラリではない。なのでbuild.grade(Module:app) に三つのライブラリを追加する。
plugins {
...
id 'kotlin-kapt'
}
dependencies {
...
// dagger2
def DAGGER_VERSION = '2.26'
implementation "com.google.dagger:dagger:$DAGGER_VERSION"
kapt "com.google.dagger:dagger-compiler:$DAGGER_VERSION"
implementation "com.google.dagger:dagger-android:$DAGGER_VERSION"
implementation "com.google.dagger:dagger-android-support:$DAGGER_VERSION"
kapt "com.google.dagger:dagger-android-processor:$DAGGER_VERSION"
...
}
ライブラリ名の通りにDaggerがAndroidを支援する（DaggerApplication, AndroidInjectorなとのインターフェース）ために必要だ。
Daggerを使う目的はClass間に依存関係を減らすためなのでTopLevel(アプリケーション単位)でDagger関連の宣言が必要だ。
宣言は三つぐらいがありそれぞれのパタンーで作れる。
// MyApplicationはすでにあった場合
public class MyApplication extends Application {
public static MyFirstComponent myFirstComponent;
@Override
public void onCreate() {
super.onCreate();
// 既存のコードにこれを追加する
myFirstComponent = DaggerMyFirstComponent
.builder()
.build();
}
}
//-----------------------//
// package name/mydi/components/MyFirstComponent.java
//-----------------------//
// Singletone スコープはアプリケーションの全範囲
// このコンポーネントはMyFirstModule.classを持つ
// Daggerが自動にDaggerMyFirstModuleというクラスを作る
@Singleton
@Component(modules = {MyFirstModule.class})
public interface MyFirstComponent {
FirstViewModel firstViewModel();
SecondViewModel secondViewModel();
}
//-----------------------//
// package name/mydi/modules/MyFirstComponent.java
//-----------------------//
@Singleton
@Module
public class MyFirstModule {
@Singleton
@Provides public FirstViewModel firstViewModel() {
return new FirstViewModel();
}
@Singleton
@Provides public SecondViewModel secondViewModel() {
return new SecondViewModel();
}
}
//-----------------------//
// package name/viewmodel/FirstViewModel.java
//-----------------------//
public class FirstViewModel {
@Inject
public FirstViewModel() {}
public String getSay() {
return "Say First Module";
}
}
//-----------------------//
// package name/viewmodel/SecondViewModel.java
//-----------------------//
public class SecondViewModel {
@Inject
public SecondViewModel() {}
public String getSay() {
return "Say Second Module";
}
}
//
public class MainActivity extends AppCompatActivity {
@Inject
public FirstViewModel firstViewModel;
@Inject
public SecondViewModel secondViewModel;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
firstViewModel = MyApplication.component.firstViewModel();
secondViewModel = MyApplication.component.secondViewModel();
}
}
一旦、FirstViewModelとSecondViewModelがMainActiviy内でnewを使わなくてもインスタンスを生成できたのは良いところだ。
しかし、これは依存関係を減らしただけだ。新しいものが追加されたら直接に修正しなければいけないのでこちらはあんまりに使わないかもしれない。
//-----------------------//
// App.kt
//-----------------------//
class App : Application(), HasAndroidInjector { //HasAndroidInjectorを継承する
@Inject lateinit var androidInjector: DispatchingAndroidInjector<Any>
override fun androidInjector(): AndroidInjector<Any> {
DaggerAppComponent.factory().create(this).inject(this)
return androidInjector
}
}
//-----------------------//
// AppComponent.kt
//-----------------------//
@Singleton
@Component(
modules = [
AndroidInjectionModule::class, //AndroidSupportInjectionModuleからAndroidInjectionModuleに変更
ActivityBindingModule::class,
AppModule::class
]
)
//-----------------------//
// MainActivity.kt
//-----------------------//
class MainActivity : AppCompatActivity(), HasAndroidInjector {
@Inject
lateinit var androidInjector: DispatchingAndroidInjector<Any>
@Inject
lateinit var prefs: SharedPreferenceStorage
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
AndroidInjection.inject(this)
}
override fun androidInjector(): AndroidInjector<Any> {
return androidInjector
}
}
//-----------------------//
// App.kt
//-----------------------//
// DaggerApplicationを継承してAppComponenのfactoryを実行する
class App : DaggerApplication() {
override fun applicationInjector(): AndroidInjector<out DaggerApplication> {
return DaggerAppComponent.factory()
.create(this)
}
}
//-----------------------//
// your package/di/AppComponentt.kt
//-----------------------//
// このファイルはDaggerがDaggerAppComponentに実装して提供する
@Singleton
@Component(
//アプリに使うModuleを定義する
modules = [
AndroidInjectionModule::class,
AppModule::class,
MainActivityBuilder::class,
RepositoryModule::class
]
)
interface AppComponent : AndroidInjector<App> {
@Component.Factory
interface Factory {
fun create(@BindsInstance app: App): AppComponent
}
}
//-----------------------//
// your package/di/AppModule.kt
//-----------------------//
// Global Application ContextためのModule
@Module
abstract class AppModule {
@Binds
abstract fun provideContext(application: App): Context
}
@Singleton
//-----------------------//
// your package/di/ui/MainActivityBuilder.kt
//-----------------------//
// ContributesAndroidInjectorにより自動にMainActivityModuleが連携される
@Module
abstract class MainActivityBuilder {
@ContributesAndroidInjector(modules = [MainActivityModule::class])
abstract fun bindMainActivity(): MainActivity
}
//-----------------------//
// your package/di/ui/MainActivityModule.kt
//-----------------------//
@Module
interface MainActivityModule {
@Binds
@IntoMap @ViewModelKey(MainViewModelImpl::class)
fun bindMainViewModel(viewModel: MainViewModelImpl): ViewModel
@ContributesAndroidInjector
fun bindMainFragment(): MainFragment
}
//-----------------------//
// your package/di/ui/MainActivityModule.kt
//-----------------------//
@Module
interface MainActivityModule {
@Binds
@IntoMap @ViewModelKey(MainViewModelImpl::class)
fun bindMainViewModel(viewModel: MainViewModelImpl): ViewModel
@ContributesAndroidInjector
fun bindMainFragment(): MainFragment
}
//-----------------------//
// your package/ui/MainFragment.kt
//-----------------------//
class MainFragment : DaggerFragment() {
@Inject
lateinit var viewModelFactory: ViewModelFactory
private val viewModel: MainViewModel by lazy {
ViewModelProvider(this, viewModelFactory).get(MainViewModelImpl::class.java)
}
override fun onCreateView(
inflater: LayoutInflater, container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
viewModel.getRepo()
viewModel.repo.observe(this, Observer {
Toast.makeText(
context,
"id = ${it.id}, title = ${it.title}, content = ${it.content}",
Toast.LENGTH_SHORT
).show()
})
return inflater.inflate(R.layout.fragment_main, container, false)
}
}
//-----------------------//
// your package/ui/MainViewModel.kt
//-----------------------//
interface MainViewModel {
val repo: LiveData<Repo>
fun getRepo()
}
class MainViewModelImpl @Inject constructor(private val repository: MainRepository) : ViewModel(),
MainViewModel {
override val repo = MutableLiveData<Repo>()
override fun getRepo() {
val data = repository.getRepo()
repo.postValue(data)
}
}
//-----------------------//
// your package/di/RepositoryModule.kt
//-----------------------//
@Module
internal object RepositoryModule {
@Singleton
@Provides fun provideMainRepository(): MainRepository =
MainRepositoryImpl()
}
//-----------------------//
// your package/MainRepository.kt
//-----------------------//
interface MainRepository {
fun getRepo(): Repo
}
class MainRepositoryImpl : MainRepository {
override fun getRepo(): Repo {
return Repo(id = 1, title = "タイトル", content = "内容")
}
}
data class Repo(
val id: Int,
val title: String,
val content: String
)
//-----------------------//
// your package/di/viewmodel/ViewModelKey.kt
//-----------------------//
@MustBeDocumented
@Target(
AnnotationTarget.FUNCTION,
AnnotationTarget.PROPERTY_GETTER,
AnnotationTarget.PROPERTY_SETTER
)
@Retention(AnnotationRetention.RUNTIME)
@MapKey internal annotation class ViewModelKey(val value: KClass<out ViewModel>)
//-----------------------//
// your package/di/viewmodel/ViewModelFactory.kt
//-----------------------//
class ViewModelFactory @Inject constructor(
private val creators: Map<Class<out ViewModel>, @JvmSuppressWildcards Provider<ViewModel>>
) : ViewModelProvider.Factory {
override fun <T : ViewModel> create(modelClass: Class<T>): T {
var creator: Provider<out ViewModel>? = creators[modelClass]
if (creator == null) {
for ((key, value) in creators) {
if (modelClass.isAssignableFrom(key)) {
creator = value
break
}
}
}
if (creator == null) {
throw IllegalArgumentException("unknown model class " + modelClass)
}
try {
@Suppress("UNCHECKED_CAST")
return creator.get() as T
} catch (e: Exception) {
throw RuntimeException(e)
}
}
}
HiltやKoin使うともっと簡単に設定ができる！
HiltやKoin使おう！
라이프사이클
Fragment
viewModel.getMainTab().observe(getViewLifecycleOwner(), new Observer<Integer>() {
@Override
public void onChanged(@Nullable Integer integer) {
//Do something
}
});
RecycleView
protected Parcelable rcListState;
@Override
public void onPause() {
super.onPause();
rcListState= rcList.getLayoutManager().onSaveInstanceState();
}
@Override
public void onResume() {
super.onResume();
if (rcListState!= null) {
rcList.getLayoutManager().onRestoreInstanceState(rcListState);
rcListState= null;
}
}
2. 리사이클뷰가 스크롤이 끝났을때 콜백액션
Cannot call this method while RecyclerView is computing a layout or scrolling
처럼에러가 나올때는 스크롤이 끝난 시점에 추가로드 등을 하기위해서 리사이클뷰의 post 에서 실행하면된다.
~~~java
@Override public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);
if() {
recyclerView.post(callbacks); 또는
recyclerView.post(() -> 실행할메소드());또는
recyclerView.post(new Runnable() {
@Override
public void run() {
실행할메소드()
}
});
}
}
~~~
<?xml version="1.0" encoding="utf-8"?>
<resources>
<declare-styleable name="OwnCustomView">
<attr name="fillColor" format="color"/>
</declare-styleable>
</resources>
레이아웃에서는
<com.customview.OwnCustomView
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:fillColor="@android:color/holo_blue_dark"/>
int fillColor;
TypedArray ta =
context.getTheme().obtainStyledAttributes(attributeSet,
R.styleable.OwnCustomView, 0, 0);
try {
fillColor =
ta.getColor(R.styleable.OwnCustomView_ocv_fillColor,
DEFAULT_FILL_COLOR);
} finally {
ta.recycle();
}
OwnCustomView customView = new OwnCustomView(this);
customView.setFillColor(BRIGHT_GREEN);
빌드상수로 디버그빌드와 릴리스빌드때 서로 다른 서버URL값 설정하기.
프로그램에서 서버 URL 등을 디버그나 테스트,개발시에 다르게 설정할수 있는데 Gradle 에서 설정한 값들은 java 에서는 “BuildConfig.속성” 처럼 상수로 접근할수 있다.
buildTypes{
release {
buildConfigField "String", "SERVER_URL", '"https://www.release.com"'
}
debug {
buildConfigField "String", "SERVER_URL", '"https://www.test.com"'
}
ProGuard
프로가드는 minifyEnabled 를 true 로 줌으로서 활성화할수있다. 이런저런 라이브러리를 사용하여 난독화하면 단일dex 파일이 너무 커지거나 라이브러리의 난독화과정에서 빌드에러가 나오는경우도 있는데 그럴경우
proguard-rules.pro파일에
-dontwarn okio.**
-dontwarn retrofit2.**
처럼 추가해주면된다.
디버그 상태에서는 별도의 프로가드 설정을 주거나 [proguardFile ‘proguard-debug.pro’] minifyEnabled 를 false 로 지정하여 원활히 디버깅이 되도록 할수있다.
또한 각각의 라이브러리는 별도의 프로가드 파일을 지정하여 주면 좋다.
proguardFiles 'proguard-rules-retrofit.pro'
proguardFiles 'proguard-rules-rx.pro'
shrinkResources
불필요한 리소스를 제거해준다. true 로 해준다.
gradlewrapper
gradlew 명령어로 gradlew clean build assemble 하면 gradle 시에 에러 정보가 보인다.
TEST
buildTypes{
release {
buildConfigField "String", "SERVER_URL", '"https://www.release.com"'
}
debug {
buildConfigField "String", "SERVER_URL", '"https://www.test.com"'
}
dependencies {
androidTestImplementation 'androidx.test:rules:1.2.0' 이건rule 위해.
androidTestImplementation 'androidx.test.ext:junit:1.1.2-alpha02' 추가
androidTestImplementation 'androidx.test.espresso:espresso-intents:3.2.0' Intent,hasComponent 사용
}
public class TCS1_010 {
@Rule
public final ActivityTestRule<MainActivity> mActivityTestRule = new ActivityTestRule<>(MainActivity.class);
@Test
public void startApp() {
Intent intent = new Intent();
// intent.putExtra("your_key", "your_value");
mActivityTestRule.launchActivity(intent);
}
}
SQLite
AndroidStudio\plugins\android\lib\templates\밑에 있는 파일대로 만들면된다.
}
ETC
AndroidStudio\plugins\android\lib\templates\밑에 있는 파일대로 만들면된다.
}
Jetpack의 Navigation 기능제공으로 안드로이드에서도 XCode처럼 화면간 이동관계를 그래프형식으로 보면서 작성할수 있게 되었다.
화면(Activity 또는 Fragment)사이에 데이터를 전달하기 위해서는 Bundle에 담아서 하곤했는데, Safe-Args를 이용하면 데이터를 전달할때 서로다른 타입으로 처리하려고 하는에러를 미리 방지할수 있고 좀더 간단하게 처리할수 있도록 도와준다.
의존 class path 를 추가한다.
buildscript {
...
dependencies {
...
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.3.5"
}
}
Safe-Args는 Gradle에서 Plugin 형태로 동작한다. 이 플러그인은 나중에 safearg로 지정된 데이터타입을 기반으로 자동으로 해당 코드들을 생성해준다.
apply plugin: "androidx.navigation.safeargs.kotlin" // kotlin only
// apply plugin: "androidx.navigation.safeargs" java and kotlin ( will be generated java source code)
또는
plugins {
...
id 'androidx.navigation.safeargs.kotlin' // kotlin only
// id "androidx.navigation.safeargs" java and kotlin ( will be generated java source code)
}
// navigation 을 사용하기 위해추가
dependencies {
...
def nav_version = "2.3.5"
// Kotlin
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
}
기본타입(Integer, Float, Long, Boolean) 부터 String, Parceable, Serializable, Enum, resource reference 등까지 가능하다.
Navigation 은 특정 Component(주로 Fragment) 에 NavHostFragment 컨테이너를 지정하여 지정된 fragment 가 Host 역활을 하도록 하게 한다.
만일 Fragment 을 이동하는거라면 같은 Activity 내에서 호스트영역에 바꿔가며 보여주는 것이 가능하고, Activity 라면 새로운 화면으로 이동하는것이 가능하다.
// your_nav_graph.xml
<!-- res 폴더에서 오른쪽버튼 - New - Android Resource File 을 선택한다음, 대화상자에서 Resource type: Navagation 을 선택하여 navigation graph 파일을 생성한다. -->
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/your_nav_graph"
app:startDestination="@id/yourFistFragment">
</navigation>
// activity_main.xml
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
>
<!-- 아래의 fragment 를 직접 입력해도 되고, Palete - Containers - NavHostFragment 를 activity화면에 드래그 하면 자동으로 아래의 태그가 추가된다.( 단 , Resources 의 navigation/your_nav_graph xml 파일은 생성되어 있어야 된다. -->
<fragment
android:id="@+id/nav_host"
android:name="androidx.navigation.fragment.NavHostFragment"
android:layout_width="0dp"
android:layout_height="0dp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
app:defaultNavHost="true"
app:navGraph="@navigation/your_nav_graph"
/>
<com.google.android.material.bottomnavigation.BottomNavigationView
android:id="@+id/main_bottom_navigation"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:menu="@menu/menu_bottom_navigation"
/>
</androidx.constraintlayout.widget.ConstraintLayout>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".BlankFragment"
>
<!-- TODO: Update blank fragment layout -->
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="@string/hello_blank_fragment"
/>
</FrameLayout>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/your_nav_graph"
app:startDestination="@id/blankFragment2">
<fragment
android:id="@+id/blankFragment2"
android:name="com.sugoigroup.nav11.BlankFragment"
android:label="fragment_blank"
tools:layout="@layout/fragment_blank" >
<action
android:id="@+id/action_blankFragment2_to_loginFragment"
app:destination="@id/loginFragment" />
<argument
android:name="param_count"
app:argType="integer"
android:defaultValue="0" />
</fragment>
<fragment
android:id="@+id/loginFragment"
android:name="com.sugoigroup.nav11.ui.login.LoginFragment"
android:label="fragment_login"
tools:layout="@layout/fragment_login" >
<action
android:id="@+id/action_loginFragment_to_mainActivity22"
app:destination="@id/otherActivity" />
</fragment>
<navigation android:id="@+id/otherActivity"
app:startDestination="@id/mainActivity22">
<activity
android:id="@+id/mainActivity22"
android:name="com.sugoigroup.nav11.MainActivity2"
android:label="activity_main2"
tools:layout="@layout/activity_main2" />
</navigation>
</navigation>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@id/blankFragment2"
android:icon="@drawable/ic_android"
android:title="@string/title_menu_first" />
<item
android:id="@id/loginFragment"
android:title="@string/title_menu_second" />
<item
android:id="@id/otherActivity"
android:title="@string/title_menu_three" />
</menu>
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val your_bottom_navigation = findViewById<BottomNavigationView>(R.id.your_bottom_navigation)
NavigationUI.setupWithNavController(your_bottom_navigation, findNavController(R.id.your_nav_host))
}
}
<navigation ...>
/*
<fragment
...
android:name="com.sugoigroup.nav11.BlankFragment"
... >
<action
...
app:destination="@id/loginFragment" />
<argument
android:name="param_count"
app:argType="integer"
android:defaultValue="0" />
</fragment>
<fragment
...
android:name="com.sugoigroup.nav11.ui.login.LoginFragment"
... >
</fragment>
*/
// LoginFragment.kt
class LoginFragment : Fragment() {
val myFromBlankParam by navArgs<BlankFragmentArgs>()
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
val myFutureAge = myFromBlankParam.paramCount * 2
}
}
버튼을 눌렀을때등 화면이동을 수동으로 할수 있다.
Navigation.findNavController(view).navigate(R.id.액션id또는목적지id);
// 액션id또는목적지id 는 loginFragment 또는 action_loginFragment_to_mainActivity22 가 될수 있다.
// action id 를 지정하는게 애니메이션효과등을 출수 있기 때문에 더 좋다.
<fragment
android:id="@+id/loginFragment"
android:name="com.sugoigroup.nav11.ui.login.LoginFragment"
android:label="fragment_login"
tools:layout="@layout/fragment_login" >
<action
android:id="@+id/action_loginFragment_to_mainActivity22"
app:destination="@id/otherActivity" />
</fragment>
Pop Behavior - popUpToIncursive 옵션을 true 로 하면 현재 화면에서 다음화면으로 넘어갈경우 스택이 쌓지않고 이동하도록 한다.
Pop Behavior - popUpTo 는 쌓여있는 스택을 모두 popup 시키고 마지막 화면만 남아있도록 한다.
Deep link - 외부에서 URI를 통해서 현재 화면에 바로 들어 접속할수 있도록 딥링크주소를 만들수 있다.
