--- /dev/null
+bin/
+obj/
+*.exe
+*.dll
+*.csproj.user
+*.lock.json
+.vs/
--- /dev/null
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ 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.
--- /dev/null
+<manifest>
+ <request>
+ <domain name="_"/>
+ </request>
+</manifest>
--- /dev/null
+Name: csapi-context
+Summary: Tizen Context API for C#
+Version: 1.0.0
+Release: 1
+Group: Development/Libraries
+License: Apache-2.0
+URL: https://www.tizen.org
+Source0: %{name}-%{version}.tar.gz
+Source1: %{name}.manifest
+
+AutoReqProv: no
+ExcludeArch: aarch64
+
+BuildRequires: dotnet-build-tools
+
+# C# API Requires
+BuildRequires: csapi-tizen-nuget
+
+%define Assemblies Tizen.Context
+
+%description
+%{summary}
+
+%dotnet_import_sub_packages
+
+%prep
+%setup -q
+cp %{SOURCE1} .
+
+%build
+for ASM in %{Assemblies}; do
+%dotnet_build $ASM
+%dotnet_pack $ASM
+done
+
+%install
+for ASM in %{Assemblies}; do
+%dotnet_install $ASM
+done
+
+%files
+%manifest %{name}.manifest
+%license LICENSE
+%attr(644,root,root) %{dotnet_assembly_files}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+using System.Runtime.InteropServices;
+
+internal static partial class Interop
+{
+ internal static partial class CtxHistory
+ {
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_query")]
+ internal static extern int Query(string uri, Int64 startTime, Int64 endTime, uint resultSize, out IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_is_supported")]
+ internal static extern int IsSupported(string subject, out bool supported);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_get_last_fully_charged_time")]
+ internal static extern int GetLastFullyChargedTime(out Int64 timestamp);
+
+ }
+ internal static partial class CtxHistoryCursor
+ {
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_destroy")]
+ internal static extern void Destroy(IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_get_count")]
+ internal static extern int GetCount(IntPtr cursor, out int count);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_get_position")]
+ internal static extern int GetPosition(IntPtr cursor, out int position);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_set_position")]
+ internal static extern int SetPosition(IntPtr cursor, int position);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_first")]
+ internal static extern int First(IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_last")]
+ internal static extern int Last(IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_next")]
+ internal static extern int Next(IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_prev")]
+ internal static extern int Prev(IntPtr cursor);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_get_int64")]
+ internal static extern int GetInt64(IntPtr cursor, string key, out Int64 value);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_get_double")]
+ internal static extern int GetDouble(IntPtr cursor, string key, out double value);
+
+ [DllImport(Library.AppHistory, EntryPoint = "ctx_history_cursor_get_string")]
+ internal static extern int GetString(IntPtr cursor, string key, out string value);
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+internal static partial class Interop
+{
+ internal static partial class Library
+ {
+ public const string AppHistory = "libcontext-app-history-client.so.4";
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+using Tizen.Internals.Errors;
+
+namespace Tizen.Context.AppHistory
+{
+ internal enum AppHistoryError
+ {
+ None = ErrorCode.None,
+ InvalidParameter = ErrorCode.InvalidParameter,
+ OutOfMemory = ErrorCode.OutOfMemory,
+ PermissionDenied = ErrorCode.PermissionDenied,
+ NotSupported = ErrorCode.NotSupported,
+ NoData = ErrorCode.NoData,
+ OperationFailed = -0x02480000 | 0x04,
+ }
+
+ internal static class AppHistoryErrorFactory
+ {
+ internal const string LogTag = "Tizen.Context.AppHistory";
+
+ internal static Exception CheckAndThrowException(AppHistoryError error, string msg)
+ {
+ switch (error)
+ {
+ case AppHistoryError.None:
+ return null;
+ case AppHistoryError.InvalidParameter:
+ return new ArgumentException("Invalid Parameter: " + msg);
+ case AppHistoryError.OutOfMemory:
+ return new OutOfMemoryException("Out of Memory: " + msg);
+ case AppHistoryError.PermissionDenied:
+ return new UnauthorizedAccessException("Permission Denied: " + msg);
+ case AppHistoryError.NotSupported:
+ return new NotSupportedException("Not Supported: " + msg);
+ case AppHistoryError.OperationFailed:
+ return new InvalidOperationException("Operation Failed: " + msg);
+ default:
+ return new InvalidOperationException("Unknown Error Code: " + msg);
+ }
+ }
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// Base class for application statistics.
+ /// </summary>
+ public abstract class AppStatistics
+ {
+ internal const string AppStatsQueryResult = "QueryResult";
+ internal const string AppStatsStartTime = "StartTime";
+ internal const string AppStatsEndTime = "EndTime";
+ internal const string AppStatsResultSize = "ResultSize";
+ internal const string AppStatsAppId = "AppId";
+ internal const int DefaultResultSize = 5;
+
+ internal string Uri;
+
+ internal AppStatistics()
+ {
+ }
+
+ internal static long ConvertDateTimeToUnixTimestamp(DateTime dateTime)
+ {
+ DateTime unixStart = new DateTime(1970, 1, 1, 0, 0, 0, 0, DateTimeKind.Utc);
+ long unixTimestampInTicks = (dateTime.ToUniversalTime() - unixStart).Ticks;
+ return unixTimestampInTicks / TimeSpan.TicksPerSecond;
+ }
+
+ internal static DateTime ConvertUnixTimestampToDateTime(long unixTime)
+ {
+ DateTime unixStart = new DateTime(1970, 1, 1, 0, 0, 0, 0, System.DateTimeKind.Utc);
+ long unixTimeStampInTicks = unixTime * TimeSpan.TicksPerSecond;
+ return new DateTime(unixStart.Ticks + unixTimeStampInTicks, System.DateTimeKind.Utc).ToLocalTime();
+ }
+
+ internal static void CheckTimeSpan(DateTime startTime, DateTime endTime)
+ {
+ if (startTime > endTime)
+ {
+ Log.Error(AppHistoryErrorFactory.LogTag, "endTime should be greater than startTime");
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.InvalidParameter, "endTime should be greater than startTime");
+ }
+ }
+
+ internal static void CheckResultSize(uint resultSize)
+ {
+ if (resultSize <= 0)
+ {
+ Log.Error(AppHistoryErrorFactory.LogTag, "resultSize should be greater than 0");
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.InvalidParameter, "resultSize should be greater than 0");
+ }
+ }
+
+ internal abstract string ConvertSortOrderToString(int order);
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// Base class which contains application statistics query result.
+ /// </summary>
+ public abstract class AppStatisticsData
+ {
+ internal AppStatisticsData()
+ {
+ }
+
+ /// <summary>
+ /// Gets the application id.
+ /// </summary>
+ /// <value>The application id.</value>
+ public string AppId { get; protected set; }
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+using System.Collections.Generic;
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// This class provides APIs to query battery consumption per application.
+ /// </summary>
+ public class BatteryStatistics : AppStatistics
+ {
+ private const string AppStatsConsumption = "TotalAmount";
+
+ /// <summary>
+ /// The default constructor of BatteryStatistics class.
+ /// </summary>
+ /// <feature>http://tizen.org/feature/battery</feature>
+ /// <exception cref="InvalidOperationException">Thrown when method fail due to internal error.</exception>
+ /// <exception cref="NotSupportedException">Thrown when the statistics is not supported.</exception>
+ public BatteryStatistics()
+ {
+ SortOrder = SortOrderType.ConsumptionMost;
+ Uri = ConvertSortOrderToString((int)SortOrder);
+
+ bool isSupported = false;
+ int error = Interop.CtxHistory.IsSupported(Uri, out isSupported);
+ if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, Uri);
+ }
+
+ if (!isSupported)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.NotSupported, Uri);
+ }
+ }
+
+ /// <summary>
+ /// The constructor of BatteryStatistics class.
+ /// </summary>
+ /// <param name="order">The criteria of the battery statistics sorted by.</param>
+ /// <feature>http://tizen.org/feature/battery</feature>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when method fail due to internal error.</exception>
+ /// <exception cref="NotSupportedException">Thrown when the statistics is not supported.</exception>
+ public BatteryStatistics(SortOrderType order)
+ {
+ SortOrder = order;
+ Uri = ConvertSortOrderToString((int)SortOrder);
+
+ if (Uri == null)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.InvalidParameter, "Invalid SortOrderType");
+ }
+
+ bool isSupported = false;
+ int error = Interop.CtxHistory.IsSupported(Uri, out isSupported);
+ if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, Uri);
+ }
+
+ if (!isSupported)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.NotSupported, Uri);
+ }
+ }
+
+ /// <summary>
+ /// Retrieves a given type of battery statistics.
+ /// </summary>
+ /// <param name="startTime">The start time of the data to be aggregated.</param>
+ /// <param name="endTime">The end time of the data to be aggregated.</param>
+ /// <returns>Battery statistics data retrieved.</returns>
+ /// <privilege>http://tizen.org/privilege/apphistory.read</privilege>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when invalid operation occurs.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when the app has no privilege to retrieve app history.</exception>
+ public IReadOnlyList<BatteryStatisticsData> Query(DateTime startTime, DateTime endTime)
+ {
+ CheckTimeSpan(startTime, endTime);
+
+ return Query(startTime, endTime, DefaultResultSize);
+ }
+
+ /// <summary>
+ /// Retrieves a given type of battery statistics.
+ /// </summary>
+ /// <param name="startTime">The start time of the data to be aggregated.</param>
+ /// <param name="endTime">The end time of the data to be aggregated.</param>
+ /// <param name="resultSize">The number of data records to be retrieved.</param>
+ /// <returns>Battery statistics data retrieved.</returns>
+ /// <privilege>http://tizen.org/privilege/apphistory.read</privilege>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when invalid operation occurs.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when the app has no privilege to retrieve app history.</exception>
+ public IReadOnlyList<BatteryStatisticsData> Query(DateTime startTime, DateTime endTime, uint resultSize)
+ {
+ CheckTimeSpan(startTime, endTime);
+ CheckResultSize(resultSize);
+
+ List<BatteryStatisticsData> result = new List<BatteryStatisticsData>();
+
+ IntPtr cursor = IntPtr.Zero;
+ int error = Interop.CtxHistory.Query(Uri, (int)ConvertDateTimeToUnixTimestamp(startTime), (int)ConvertDateTimeToUnixTimestamp(endTime), resultSize, out cursor);
+ if ((AppHistoryError)error == AppHistoryError.NoData)
+ {
+ return result.AsReadOnly();
+ }
+ else if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ Log.Error(AppHistoryErrorFactory.LogTag, "Failed to request query battery statistics");
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, "Failed to request query battery statistics");
+ }
+
+ int size;
+ error = Interop.CtxHistoryCursor.GetCount(cursor, out size);
+ Interop.CtxHistoryCursor.First(cursor);
+
+ for (int i = 0; i < size; i++)
+ {
+ result.Add(ConvertOutputToStatsData(cursor));
+ Interop.CtxHistoryCursor.Next(cursor);
+ }
+ Interop.CtxHistoryCursor.Destroy(cursor);
+
+ return result.AsReadOnly();
+ }
+
+ /// <summary>
+ /// Gets the last time when the device was fully charged.
+ /// </summary>
+ /// <returns>The last time when the device was fully charged.</returns>
+ /// <feature>http://tizen.org/feature/battery</feature>
+ /// <exception cref="NotSupportedException">Thrown when the statistics is not supported.</exception>
+ public static DateTime GetLastFullyChargedTime()
+ {
+ Int64 timestamp;
+ int error = Interop.CtxHistory.GetLastFullyChargedTime(out timestamp);
+ if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ Log.Error(AppHistoryErrorFactory.LogTag, "Failed to request get last fully charged time");
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, "Failed to request get last fully charged time");
+ }
+
+ return ConvertUnixTimestampToDateTime(timestamp);
+ }
+
+ internal override string ConvertSortOrderToString(int order)
+ {
+ switch ((SortOrderType)order)
+ {
+ case SortOrderType.ConsumptionMost:
+ return "stats/battery/history";
+ default:
+ return null;
+ }
+ }
+
+ private static BatteryStatisticsData ConvertOutputToStatsData(IntPtr cursor)
+ {
+ string appId;
+ double consumption;
+
+ Interop.CtxHistoryCursor.GetString(cursor, AppStatsAppId, out appId);
+ Interop.CtxHistoryCursor.GetDouble(cursor, AppStatsConsumption, out consumption);
+
+ return new BatteryStatisticsData(appId, consumption);
+ }
+
+ /// <summary>
+ /// Gets the criteria of battery statistics sorted by.
+ /// </summary>
+ /// <value>The criteria of battery statistics sorted by.</value>
+ public SortOrderType SortOrder { get; private set; }
+
+ /// <summary>
+ /// Sort order type of battery statistics.
+ /// </summary>
+ public enum SortOrderType
+ {
+ /// <summary>
+ /// Sorts apps by consumption, the most battery consuming apps appear first. (Default)
+ /// </summary>
+ ConsumptionMost = 0
+ }
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// The class contains battery statistics information retrieved by BatteryStatistics.
+ /// </summary>
+ public class BatteryStatisticsData : AppStatisticsData
+ {
+ internal BatteryStatisticsData(string appId, double consumption)
+ {
+ AppId = appId;
+ Consumption = consumption;
+ }
+
+ /// <summary>
+ /// Gets how many percentage of battery capacity was used by the application.
+ /// </summary>
+ /// <value>Battery consumption used by the application.</value>
+ public double Consumption { get; private set; }
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+using System.Collections.Generic;
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// This class provides APIs to query application launch history.
+ /// </summary>
+ public class UsageStatistics : AppStatistics
+ {
+ private const string AppStatsDuration = "TotalDuration";
+ private const string AppStatsLaunchCount = "TotalCount";
+ private const string AppStatsLastLaunchTime = "LastTime";
+
+ /// <summary>
+ /// The default constructor of UsageStatistics class.
+ /// </summary>
+ /// <exception cref="InvalidOperationException">Thrown when method fail due to internal error.</exception>
+ public UsageStatistics()
+ {
+ SortOrder = SortOrderType.LastLaunchTimeNewest;
+ Uri = ConvertSortOrderToString((int)SortOrder);
+
+ bool isSupported = false;
+ int error = Interop.CtxHistory.IsSupported(Uri, out isSupported);
+ if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, Uri);
+ }
+
+ if (!isSupported)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.OperationFailed, Uri);
+ }
+ }
+
+ /// <summary>
+ /// The constructor of UsageStatistics class.
+ /// </summary>
+ /// <param name="order">The criteria of the usage statistics sorted by.</param>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when method fail due to internal error.</exception>
+ public UsageStatistics(SortOrderType order)
+ {
+ SortOrder = order;
+ Uri = ConvertSortOrderToString((int)SortOrder);
+
+ if (Uri== null)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.InvalidParameter, "Invalid SortOrderType");
+ }
+
+ bool isSupported = false;
+ int error = Interop.CtxHistory.IsSupported(Uri, out isSupported);
+ if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, Uri);
+ }
+
+ if (!isSupported)
+ {
+ throw AppHistoryErrorFactory.CheckAndThrowException(AppHistoryError.OperationFailed, Uri);
+ }
+ }
+
+ /// <summary>
+ /// Retrieves a given type of usage statistics.
+ /// </summary>
+ /// <param name="startTime">The start time of the data to be aggregated.</param>
+ /// <param name="endTime">The end time of the data to be aggregated.</param>
+ /// <returns>Usage statistics data retrieved.</returns>
+ /// <privilege>http://tizen.org/privilege/apphistory.read</privilege>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when invalid operation occurs.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when the app has no privilege to retrieve app history.</exception>
+ public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime)
+ {
+ CheckTimeSpan(startTime, endTime);
+
+ return Query(startTime, endTime, DefaultResultSize);
+ }
+
+ /// <summary>
+ /// Retrieves a given type of usage statistics.
+ /// </summary>
+ /// <param name="startTime">The start time of the data to be aggregated.</param>
+ /// <param name="endTime">The end time of the data to be aggregated.</param>
+ /// <param name="resultSize">The number of data records to be retrieved.</param>
+ /// <returns>Usage statistics data retrieved.</returns>
+ /// <privilege>http://tizen.org/privilege/apphistory.read</privilege>
+ /// <exception cref="ArgumentException">Thrown when an invalid argument is used.</exception>
+ /// <exception cref="InvalidOperationException">Thrown when invalid operation occurs.</exception>
+ /// <exception cref="UnauthorizedAccessException">Thrown when the app has no privilege to retrieve app history.</exception>
+ public IReadOnlyList<UsageStatisticsData> Query(DateTime startTime, DateTime endTime, uint resultSize)
+ {
+ CheckTimeSpan(startTime, endTime);
+ CheckResultSize(resultSize);
+
+ List<UsageStatisticsData> result = new List<UsageStatisticsData>();
+
+ IntPtr cursor = IntPtr.Zero;
+ int error = Interop.CtxHistory.Query(Uri, ConvertDateTimeToUnixTimestamp(startTime), ConvertDateTimeToUnixTimestamp(endTime), resultSize, out cursor);
+ if ((AppHistoryError)error == AppHistoryError.NoData)
+ {
+ return result.AsReadOnly();
+ } else if ((AppHistoryError)error != AppHistoryError.None)
+ {
+ Log.Error(AppHistoryErrorFactory.LogTag, "Failed to request query usage statistics");
+ throw AppHistoryErrorFactory.CheckAndThrowException((AppHistoryError)error, "Failed to request query usage statistics");
+ }
+
+ int size;
+ error = Interop.CtxHistoryCursor.GetCount(cursor, out size);
+ Interop.CtxHistoryCursor.First(cursor);
+
+ for (int i = 0; i < size; i++)
+ {
+ result.Add(ConvertOutputToStatsData(cursor));
+ Interop.CtxHistoryCursor.Next(cursor);
+ }
+ Interop.CtxHistoryCursor.Destroy(cursor);
+
+ return result.AsReadOnly();
+ }
+
+ internal override string ConvertSortOrderToString(int order)
+ {
+ switch ((SortOrderType)order)
+ {
+ case SortOrderType.LastLaunchTimeNewest:
+ return "stats/app/recently";
+ case SortOrderType.LaunchCountMost:
+ return "stats/app/often";
+ default:
+ return null;
+ }
+ }
+
+ private static UsageStatisticsData ConvertOutputToStatsData(IntPtr cursor)
+ {
+ string appId;
+ Int64 duration = 1;
+ Int64 launchCount = 1;
+ Int64 lastLaunchTime;
+
+ Interop.CtxHistoryCursor.GetString(cursor, AppStatsAppId, out appId);
+ Interop.CtxHistoryCursor.GetInt64(cursor, AppStatsDuration, out duration);
+ Interop.CtxHistoryCursor.GetInt64(cursor, AppStatsLaunchCount, out launchCount);
+ Interop.CtxHistoryCursor.GetInt64(cursor, AppStatsLastLaunchTime, out lastLaunchTime);
+
+ return new UsageStatisticsData(appId, (int)duration, (int)launchCount, ConvertUnixTimestampToDateTime(lastLaunchTime));
+ }
+
+ /// <summary>
+ /// Gets the criteria of usage statistics sorted by.
+ /// </summary>
+ /// <value>The criteria of usage statistics sorted by.</value>
+ public SortOrderType SortOrder { get; private set; }
+
+ /// <summary>
+ /// Sort order type of usage statistics
+ /// </summary>
+ public enum SortOrderType
+ {
+ /// <summary>
+ /// Sorts apps by the last launch time, the most recently launched apps appear first. (Default)
+ /// </summary>
+ LastLaunchTimeNewest = 0,
+ /// <summary>
+ /// Sorts apps by the launch count of being launched, the most frequently launched apps appear first.
+ /// </summary>
+ LaunchCountMost
+ }
+ }
+}
--- /dev/null
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * 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.
+ */
+
+using System;
+
+namespace Tizen.Context.AppHistory
+{
+ /// <summary>
+ /// The class contains application usage statistics information retrieved by UsageStatistics.
+ /// </summary>
+ public class UsageStatisticsData : AppStatisticsData
+ {
+ internal UsageStatisticsData(string appId, int duration, int launchCount, DateTime lastLaunchTime)
+ {
+ AppId = appId;
+ Duration = duration;
+ LaunchCount = launchCount;
+ LastLaunchTime = lastLaunchTime;
+ }
+
+ /// <summary>
+ /// Gets the time which the application is being displayed in the foreground in seconds.
+ /// </summary>
+ /// <value>Duration which the application is used in the foreground in seconds.</value>
+ public int Duration { get; private set; }
+
+ /// <summary>
+ /// Gets how many times the application is used in the foreground.
+ /// </summary>
+ /// <value>How many times the application is used in the foreground.</value>
+ public int LaunchCount { get; private set; }
+
+ /// <summary>
+ /// Gets the last time when the application has been used.
+ /// </summary>
+ /// <value>The last time when the application has been used.</value>
+ public DateTime LastLaunchTime { get; private set; }
+ }
+}
--- /dev/null
+<Project Sdk="Microsoft.NET.Sdk">
+
+ <PropertyGroup>
+ <Version>1.0.0</Version>
+ <Authors>Samsung Electronics</Authors>
+ <Copyright>© Samsung Electronics Co., Ltd All Rights Reserved</Copyright>
+ <Description>Provides the Context APIs for Tizen .NET</Description>
+ <PackageProjectUrl>https://www.tizen.org/</PackageProjectUrl>
+ <PackageLicenseUrl>https://www.apache.org/licenses/LICENSE-2.0</PackageLicenseUrl>
+ <PackageIconUrl>https://developer.tizen.org/sites/default/files/images/tizen-pinwheel-on-light-rgb_64_64.png</PackageIconUrl>
+ </PropertyGroup>
+
+ <PropertyGroup>
+ <TargetFramework>netstandard1.3</TargetFramework>
+ <AllowUnsafeBlocks>True</AllowUnsafeBlocks>
+ <SignAssembly>True</SignAssembly>
+ <AssemblyOriginatorKeyFile>Tizen.Context.snk</AssemblyOriginatorKeyFile>
+ <PublicSign Condition="'$(OS)' != 'Windows_NT'">true</PublicSign>
+ </PropertyGroup>
+
+ <ItemGroup>
+ <PackageReference Include="Tizen" Version="1.0.5" />
+ </ItemGroup>
+
+</Project>
--- /dev/null
+\r
+Microsoft Visual Studio Solution File, Format Version 12.00\r
+# Visual Studio 15\r
+VisualStudioVersion = 15.0.26430.12\r
+MinimumVisualStudioVersion = 10.0.40219.1\r
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Tizen.Context", "Tizen.Context.csproj", "{25C5C8F5-981D-4294-AB10-8F4F69C295C1}"\r
+EndProject\r
+Global\r
+ GlobalSection(SolutionConfigurationPlatforms) = preSolution\r
+ Debug|Any CPU = Debug|Any CPU\r
+ Release|Any CPU = Release|Any CPU\r
+ EndGlobalSection\r
+ GlobalSection(ProjectConfigurationPlatforms) = postSolution\r
+ {25C5C8F5-981D-4294-AB10-8F4F69C295C1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\r
+ {25C5C8F5-981D-4294-AB10-8F4F69C295C1}.Debug|Any CPU.Build.0 = Debug|Any CPU\r
+ {25C5C8F5-981D-4294-AB10-8F4F69C295C1}.Release|Any CPU.ActiveCfg = Release|Any CPU\r
+ {25C5C8F5-981D-4294-AB10-8F4F69C295C1}.Release|Any CPU.Build.0 = Release|Any CPU\r
+ EndGlobalSection\r
+ GlobalSection(SolutionProperties) = preSolution\r
+ HideSolutionNode = FALSE\r
+ EndGlobalSection\r
+EndGlobal\r