天气 App 中常见的 Android 自定义控件，可以用来动态展示日出和日落

最新推荐文章于 2024-03-29 17:05:29 发布

转载最新推荐文章于 2024-03-29 17:05:29 发布 · 958 阅读

1 ·

CC 4.0 BY-SA版权

原文链接：https://p.codekk.com/detail/Android/tianma8023/SunriseSunsetView

文章标签：

#android #android studio #webview

Android 不错文章转载专栏收录该内容

1078 篇文章

订阅专栏

这是一个用于Android应用的自定义视图库，可以动态展示日出和日落时间，常见于天气应用。通过添加依赖并设置日出和日落时间，可以轻松在布局中使用。该视图支持自定义属性如颜色、尺寸等，并提供了标签格式化接口。

SunriseSunsetView

项目地址：tianma8023/SunriseSunsetView

简介： :sunny: An Android view to show sunrise and sunset dynamically which is common seen in Weather App. / 天气 App 中常见的 Android 自定义控件，可以用来动态展示日出和日落。

更多：作者提 Bug

标签：

An Android view to show sunrise and sunset dynamically which is common seen in Weather App.

天气 App 中常见的 Android 自定义控件，可以用来动态展示日出和日落。

Screenshot

Import

To use this lib you need add jitpack.io repository to your root build.gradle:
```
 allprojects {
     repositories {
         jcenter()
         maven { url 'https://jitpack.io' } // add this line
     }
 }
```
Note: don't add the jitpack.io repository under buildscript closure.

Add SunriseSunsetView dependency in your module build.gradle:

 // ...
 // if Android Gradle Plugin after v3.0
 implementation 'com.github.tianma8023:SunriseSunsetView:0.0.2' 
 // if Android Gradle Plugin before v3.0
 // compile 'com.github.tianma8023:SunriseSunsetView:0.0.2'

Usage

SunriseSunsetView can be placed in layout xml file:

 <com.github.tianma8023.ssv.SunriseSunsetView
     android:id="@+id/ssv"
     android:layout_height="wrap_content"
     android:layout_margin="10dp"
     android:layout_width="match_parent"
     app:ssv_label_text_color="@color/colorAccent"
     app:ssv_label_text_size="16sp"
     app:ssv_label_horizontal_gap="12dp"
     app:ssv_label_vertical_gap="2dp"
     app:ssv_shadow_color="@color/lightGreen"
     app:ssv_sun_color="@color/amber"
     app:ssv_sun_radius="10dp"
     app:ssv_track_color="@color/teal"
     app:ssv_track_width="1.5dp"
 />

You need to set sunrise and sunset time before starting animation:

 mSunriseSunsetView = (SunriseSunsetView) findViewById(R.id.ssv);
 // ...
 mSunriseSunsetView.setSunriseTime(new Time(sunriseHour, sunriseMinute));
 mSunriseSunsetView.setSunsetTime(new Time(sunsetHour, sunsetMinute));
 // start animation
 mSunriseSunsetView.startAnimate();

Custom attributes are supported:

attribute	format	default	description
ssv_track_color	color\	reference	#FFFFFF	track color
ssv_track_width	dimension	4px	track width
ssv_sun_radius	dimension	20px	sun radius
ssv_sun_color	color\	reference	#FFFF00	sun color
ssv_shadow_color	color\	reference	#32FFFFFF	shadow color
ssv_label_text_size	dimension	40px	label text size
ssv_label_text_color	color\	reference	#FFFFFF	label text color
ssv_label_vertical_offset	dimension	5px	label vertical offset
ssv_label_horizontal_offset	dimension	20px	label horizontal offset

Other api:

// fotmat label by set label formatter
mSunriseSunsetView.setLabelFormatter(new SunriseSunsetLabelFormatter() {
    @Override
    public String formatSunriseLabel(@NonNull Time sunrise) {
        return formatLabel(sunrise);
    }

    @Override
    public String formatSunsetLabel(@NonNull Time sunset) {
        return formatLabel(sunset);
    }

    private String formatLabel(Time time) {
        return String.format(Locale.getDefault(), "%02dh %02dm", time.hour, time.minute);
    }
});

Sample

There is a sample project in this repo, or you can download demo.apk directly.

License

SunriseSunsetView    
Copyright 2018 Tianma

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.