{"id":28400471,"url":"https://github.com/droidkaigi/conference-app-2017","last_synced_at":"2025-06-28T09:32:21.789Z","repository":{"id":147823628,"uuid":"79104433","full_name":"DroidKaigi/conference-app-2017","owner":"DroidKaigi","description":"The Official Conference App for DroidKaigi 2017 Tokyo","archived":false,"fork":false,"pushed_at":"2018-09-27T06:52:53.000Z","size":12316,"stargazers_count":470,"open_issues_count":25,"forks_count":140,"subscribers_count":130,"default_branch":"master","last_synced_at":"2025-06-01T18:07:40.464Z","etag":null,"topics":["android","android-app","conference","droidkaigi"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DroidKaigi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-01-16T09:47:53.000Z","updated_at":"2024-01-04T16:10:35.000Z","dependencies_parsed_at":"2023-05-27T15:15:31.797Z","dependency_job_id":null,"html_url":"https://github.com/DroidKaigi/conference-app-2017","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DroidKaigi/conference-app-2017","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DroidKaigi%2Fconference-app-2017","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DroidKaigi%2Fconference-app-2017/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DroidKaigi%2Fconference-app-2017/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DroidKaigi%2Fconference-app-2017/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DroidKaigi","download_url":"https://codeload.github.com/DroidKaigi/conference-app-2017/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DroidKaigi%2Fconference-app-2017/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262406252,"owners_count":23306114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-app","conference","droidkaigi"],"created_at":"2025-06-01T10:37:51.283Z","updated_at":"2025-06-28T09:32:21.784Z","avatar_url":"https://github.com/DroidKaigi.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![](app/src/main/res/mipmap-mdpi/ic_launcher.png) DroidKaigi 2017 official Android app [![CircleCI](https://circleci.com/gh/DroidKaigi/conference-app-2017.svg?style=svg)](https://circleci.com/gh/DroidKaigi/conference-app-2017) [![Stories in Ready](https://badge.waffle.io/DroidKaigi/conference-app-2017.svg?label=ready\u0026title=Ready)](http://waffle.io/DroidKaigi/conference-app-2017) [![codecov](https://codecov.io/gh/DroidKaigi/conference-app-2017/branch/master/graph/badge.svg?token=lVzTk1B5fE)](https://codecov.io/gh/DroidKaigi/conference-app-2017)\n\n\n[DroidKaigi 2017](https://droidkaigi.github.io/2017/en/) is a conference tailored for developers on 9th and 10th March 2017.\n\n[\u003cimg src=\"https://dply.me/rlr6yr/button/large\" alt=\"Try it on your device via DeployGate\"\u003e](https://dply.me/8vo9g8#install)\n\n\n# Features\n\u003cimg src=\"doc/screenshot_sessions.png\" width=\"300\" /\u003e  \u003cimg src=\"doc/screenshot_session_detail.png\" width=\"300\" /\u003e\n\n- View conference schedule and details of each session\n- Set notification for upcoming sessions on your preference\n- View a map\n- Search sessions and speakers\n\n\n# Contributing\nWe use [waffle.io](https://waffle.io/DroidKaigi/conference-app-2017) to manage tasks. If you'd like to contribute to the project but are not sure where to start off, please look for issues labelled [welcome contribute](https://github.com/DroidKaigi/conference-app-2017/labels/welcome%20contribute).\n\nWe've designated these issues as good candidates for easy contribution. You can always fork the repository and send a pull request (on a branch other than `master`).\n\nWe do accept suggestions for translations at [this page](https://droidkaigi2017.oneskyapp.com/collaboration).\n\n# Development Environment\nThis app depends on several libraries and plugins so make sure to set them up correctly.\n\n## Java8 \u0026 retrolambda support\nThis project uses Java8 and [retrolambda](https://github.com/orfjackal/retrolambda). If you haven't set up Java8 yet, install it from [here](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), and set env `JAVA_HOME` or `JAVA8_HOME`.\n\n## Kotlin\nTests are written in Kotlin!\n\n## DataBinding\nThis project tries to use [DataBinding](http://developer.android.com/intl/ja/tools/data-binding/guide.html).\n\n```xml\n\u003cTextView\n  android:id=\"@+id/txt_title\"\n  android:layout_width=\"wrap_content\"\n  android:layout_height=\"wrap_content\"\n  android:maxLines=\"@{viewModel.titleMaxLines}\"\n  android:text=\"@{viewModel.title}\" /\u003e\n```\n\nCustom attributes are also used like below.\n\n```xml\n\u003cImageView\n    android:id=\"@+id/img_speaker\"\n    android:layout_width=\"@dimen/image_size\"\n    android:layout_height=\"@dimen/image_size\"\n    app:photoImageUrl=\"@{viewModel.imageUrl}\" /\u003e\n```\n\nBindingAdapter like `photoImageUrl` is written in `DataBindingHelper.java`.\n\n```java\n@BindingAdapter(\"photoImageUrl\")\npublic static void setPhotoImageUrl(ImageView imageView, @Nullable String imageUrl) {\n  setImageUrl(imageView, imageUrl, R.color.grey200);\n}\n\nprivate static void setImageUrl(ImageView imageView, @Nullable String imageUrl, @DrawableRes int placeholderResId) {\n  if (TextUtils.isEmpty(imageUrl)) {\n    imageView.setImageDrawable(ContextCompat.getDrawable(imageView.getContext(), placeholderResId));\n  } else {\n    Picasso.with(imageView.getContext())\n           .load(imageUrl)\n           .placeholder(placeholderResId)\n           .error(placeholderResId)\n           .into(imageView);\n  }\n}\n```\n\n## Dagger2\nThis project uses DI library [Dagger2](http://google.github.io/dagger/).\nSee classes in `di` package.\n\n```\nsrc/main/java/io/github/droidkaigi/confsched2017/di\n|\n|--scope\n|  |--ActivityScope.java  : Scope annotation for objects being alive within activity lifecycle\n|  |--FragmentScope.java  : Scope annotation for objects being alive within fragment lifecycle\n|\n|--AndroidModule.java     : Provides system services(e.g. PackageManager, ActivityManager)\n|--ActivityComponent.java :\n|--ActivityModule.java    : Provides activity-scoped objects\n|--AppComponent.java      :\n|--AppModule.java         : Provides application-scoped objects(e.g. SharedPreferences, HttpClient)\n|--FragmentComponent.java :\n|--FragmentModule.java    : Provides fragment-scoped objects\n```\n\n## Orma\nThis project uses ORM library [Android-Orma](http://gfx.github.io/Android-Orma/).\nAndroid-Orma is a lightning-fast and annotation based wrapper library of SQLiteDatabase.\n\nSome model classes in `model` package having `@Table` annotation.\n\n```java\n@Table\npublic class Session {\n    @Column(indexed = true)\n    @SerializedName(\"id\")\n    public int id;\n\n    @Column(indexed = true)\n    @SerializedName(\"title\")\n    public String title;\n\n    // ...\n}\n```\n\nThese classes are saved and updated in database via `repository/XXXLocalDataSource`.\nTo know more about Android-Orma, see [document](http://gfx.github.io/Android-Orma/).\n\n\n# Architecture\nThis app uses an simple MVVM (Model-View-ViewModel) architecture using DataBinding, dependency injection and OR-mapper.\n\n![](doc/architecture.png)\n\n## Model\n- In `model` package.\n- These models are POJO.\n- They are converted from API json response via [Retrofit2](https://square.github.io/retrofit/), and stored to Database via [Android-Orma](https://github.com/gfx/Android-Orma).\n\n```java\n@Table\npublic class Speaker {\n\n  @PrimaryKey(auto = false)\n  @Column(indexed = true)\n  @SerializedName(\"id\")\n  public int id;\n\n  @Column(indexed = true)\n  @SerializedName(\"name\")\n  public String name;\n\n  @Column\n  @Nullable\n  @SerializedName(\"image_url\")\n  public String imageUrl;\n\n  ...\n}\n```\n\n## View\n- In `view` package.\n- \"View\" is not only layout xml file. Activities and Fragments are also \"View\".\n- \"View\" is refreshed by viewModel when `onResume()` is called.\n\n## ViewModel\n- In `viewmodel` package\n- \"ViewModel\" has all properties which is shown in \"View\".\n- They are bound by DataBinding. In this app, `setText()`, `setImageResource()` or `setVisibility()` are not used.\n- The events such as `OnClickListener()` are also bound by DataBinding.\n\n```xml\n\u003cRelativeLayout\n  android:layout_width=\"wrap_content\"\n  android:layout_height=\"wrap_content\"\n  android:background=\"@drawable/clickable_white\"\n  android:clickable=\"@{viewModel.clickable}\"\n  android:onClick=\"@{viewModel::showSessionDetail}\"\n  app:sessionCellBackground=\"@{viewModel.backgroundResId}\"\n  app:twowayview_colSpan=\"@{viewModel.colSpan}\"\n  app:twowayview_rowSpan=\"@{viewModel.rowSpan}\"\u003e\n\n  \u003cView\n    android:id=\"@+id/categoryBorder\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"3dp\"\n    android:visibility=\"@{viewModel.normalSessionItemVisibility}\"\n    app:sessionTopicColor=\"@{viewModel.topicColorResId}\" /\u003e\n    ...\n\n\u003c/RelativeLayout\u003e\n```\n\n- \"ViewModel\" has business logic.\n- If it's necessary to load data, \"ViewModel\" uses `Repository` class or `DefaultPref` class which are provided by [Dagger2](https://github.com/google/dagger).\n\n```java\n@Inject\nSessionsViewModel(SessionsRepository sessionsRepository, MySessionsRepository mySessionsRepository) {\n  this.sessionsRepository = sessionsRepository;\n  this.mySessionsRepository = mySessionsRepository;\n}\n```\n\n\n# Credit\nThis project uses some modern Android libraries.\n\n- Android Support Libraries\n  - Support v4\n  - AppCompat\n  - Support Annotations\n  - Support Vector Drawables\n  - Animated Vector Drawables\n  - Design\n  - RecyclerView\n  - CustomTabs\n- [Firebase](https://firebase.google.com/), [Dagger2](http://google.github.io/dagger/) and [Gson](https://github.com/google/gson) - Google\n- [Retrofit2](http://square.github.io/retrofit/), [Picasso](http://square.github.io/picasso/), [OkHttp3](https://github.com/square/okhttp), [AssertJ](https://github.com/square/assertj-android) and [LeakCanary](https://github.com/square/leakcanary) - Square\n- [Android-Orma](https://github.com/gfx/Android-Orma) - gfx\n- [TwoWayView](https://github.com/lucasr/twoway-view) - Lucas Rocha\n- [RxJava2](https://github.com/ReactiveX/RxJava) and [RxAndroid2]([RxAndroid](https://github.com/ReactiveX/RxAndroid)) - ReactiveX\n- [Lightweight Stream API](https://github.com/aNNiMON/Lightweight-Stream-API) - Victor Melnik\n- [Timber](https://github.com/JakeWharton/timber) - JakeWharton\n- [Calligraphy](https://github.com/chrisjenx/Calligraphy) - Christopher Jenkins\n- [Stetho](http://facebook.github.io/stetho/) - Facebook\n- [PermissionsDispatcher](https://github.com/hotchemi/PermissionsDispatcher) - hotchemi\n- [kvs-schema](https://github.com/rejasupotaro/kvs-schema) - rejasupotaro\n- [Robolectric](http://robolectric.org/) - Robolectric\n- [Mockito](http://site.mockito.org/) - Mockito\n- [Kotlin](https://kotlinlang.org/) - JetBrains\n- [Knit](https://github.com/ntaro/knit) - Taro Nagasawa\n- [Kmockito](https://github.com/sys1yagi/kmockito) - sys1yagi\n\n\n# License\n```\nCopyright 2017 DroidKaigi\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidkaigi%2Fconference-app-2017","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdroidkaigi%2Fconference-app-2017","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdroidkaigi%2Fconference-app-2017/lists"}