spark-store-project/spark-store
15
0
Fork 0
mirror of https://gitee.com/spark-store-project/spark-store synced 2025-12-13 20:32:05 +08:00
Code Issues 1 Packages Projects Releases Wiki Activity

enhance: 文档改进

Browse Source
This commit is contained in:
uniartisan
2023-10-22 10:48:36 +08:00
parent 74d4cc05d9
commit b2fc80215d
4 changed files with 433 additions and 259 deletions
Download Patch File Download Diff File Expand all files Collapse all files

250
README.md
View File

@@ -1,153 +1,159 @@
# Spark App Store
[![star](https://gitee.com/deepin-community-store/spark-store/badge/star.svg?theme=gvp)](https://gitee.com/deepin-community-store/spark-store/stargazers) [![fork](https://gitee.com/deepin-community-store/spark-store/badge/fork.svg?theme=gvp)](https://gitee.com/deepin-community-store/spark-store/members)
# Spark App Store
[![star](https://gitee.com/deepin-community-store/spark-store/badge/star.svg?theme=gvp)](https://gitee.com/deepin-community-store/spark-store/stargazers) [![fork](https://gitee.com/deepin-community-store/spark-store/badge/fork.svg?theme=gvp)](https://gitee.com/deepin-community-store/spark-store/members)
## Introduction
Welcome to the Spark App Store! This is an app store designed for Linux users, aiming to solve the problem of dispersed and difficult-to-obtain applications in the Linux ecosystem. No matter what type of Linux distribution you are using, you may find suitable software packages here.
Spark Store aims to collect Linux apps for the convieniece of Linux new comers
The number of Linux applications is relatively limited, and the availability of Wine software is also quite challenging. Excellent development and tool resources are scattered across various communities and forums, making it difficult for the entire ecosystem to improve comprehensively.
The collecting process needs everyone's help
The construction of the ecosystem is not dependent on the isolated efforts of individuals but requires the participation of the entire community. Only when everyone's "sparks" gather together can they ignite a "prairie fire."
We set up this APP Store and collect APPs/tools that everyone need widely. Also we pack Windows apps with wine.
To improve this situation, we have launched this app store. We have broadly included various user-demand software packages, gathered high-quality tools, and actively adapted Wine applications, all stored in our software library for easy user access.
All packages will be shared in our repository for users to get freely.
**Currently supported Linux distributions include:**
Distrobution supported：
- **amd64 architecture:** deepin 20 / deepin 23 / Ubuntu 20.04 / Ubuntu 22.04 / UOS Home Edition 20
- **arm64 architecture:** UOS Professional Edition 1060 / Ubuntu 22.04 / deepin 23
* amd64: deepin 20 / deepin 23 / Ubuntu 22.04 LTS / UniontechOS Home 21
* arm64: UniontechOS Professional 1060 / Ubuntu 22.04 LTS / deepin 23
> Special Note: We also support all versions of Ubuntu operating systems higher than Ubuntu 22.04, such as Ubuntu 22.10, 23.04, 23.10, etc.
**Important Notice:** This software does not provide any form of warranty. If you plan to use it on UOS Professional Edition, please make sure to understand and enable Developer Mode. Make sure you have basic troubleshooting capabilities. It should be clear that we have not conducted extensive testing on the UOS operating system. Therefore, using the Spark client may lead to a series of issues like failed system updates, data loss, etc., all risks to be borne by the user.
You can track our Issue resoving progress here https://gitee.com/deepin-community-store/spark-store/board
## Team Collaboration: For detailed documentation related to branch management, please see [this link](https://deepin-community-store.gitee.io/spark-wiki/#/Dev/Spark-Store-Git-Repo).
We warmly welcome you to join our development team. Whether you want to participate in development or submit applications, you can find your place here to jointly promote the development of the Linux application ecosystem.
We hope people who see here can also join our team，development help or submit applications are welcomed
You can track our Issue handling status in real-time through the following link: [Gitee Issue Board](https://gitee.com/deepin-community-store/spark-store/board).
If you want to submit an APP to share with others，Please [Click here](https://upload.deepinos.org/index)
If you have a software package you'd like to submit, please [click here to submit](https://upload.deepinos.org/index).
## Contents
## 🙌 A simple start
If you simply want to install the Spark Store,just enter the [Release] page, find the version you want and install.
If you are using Debian11/Ubuntu 20.04, you will need extra dependency package. Available [here](https://zunyun01.store.deepinos.org.cn/spark-store-dependencies-kylin.zip)
---
#### Compile and developement
**dev branch is for development, Flamescion branch is for amd64 and Reason branch is for arrch64.** Although, for the most of the time, Flamescion branch is same as Reason.
For Deepin V20/UOS 21/ Debian 11
```shell
sudo apt install git qt5-default debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev fakeroot qtwayland5 qtwayland5-dev-tools dde-qt5wayland-plugin libqt5svg5*
```
Ubuntu 22.04
```shell
sudo apt install git qtbase5-dev debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev qtwayland5 qtwayland5-dev-tools libqt5svg5*
```
Then
```shell
git clone https://gitee.com/deepin-community-store/spark-store.git
cd spark-store
dpkg-buildpackage -j
```
Or:
```shell
git clone https://gitee.com/deepin-community-store/spark-store.git
cd spark-store
./build_and_install.sh
```
## EULA
This is our [EULA](https://genshin-impact.fandom.com/wiki/Eula)
## 🚀 Coorperation
We use Gitee as our code hosting platform. Please click here to contact us.
https://gitee.com/deepin-community-store/spark-store
### Forum
https://www.deepinos.org/
#### QQ Group
https://blog.shenmo.tech/post/%E6%95%85%E9%9A%9C%E5%85%AC%E5%91%8A/
## FAQ
### Spark Application Store FAQ and Support Guide
#### Introduction
The Spark Application Store is an application store for Linux users, supporting various Linux distributions. Here are some common questions and solutions. Please note that this document is primarily aimed at ordinary users who are not familiar with Linux and the APT software package management system.
- [Determine your system architecture](#determine-your-system-architecture)
- [System support and installation guide](#system-support-and-installation-guide)
- [For Deepin / UOS Users](#for-deepin-users)
- [For Ubuntu Users](#for-ubuntu-users)
- [For Debian Users](#for-debian-users)
- [Frequently Asked Questions (FAQ)](#frequently-asked-questions-faq)
- [Contact and Feedback](#contact-and-feedback)
---
#### Communication and Feedback
**Q: Where can I join the communication group?**
**A:** You can click [here](https://www.deepinos.org/) to access the main communication platform for the Spark Store.
> ⚠️ If the above link is not accessible, you can also join our QQ groups as an alternative, with group numbers 872690351 and 865927727. We also provide a forum as a communication platform.
## Determine your system architecture
#### Differences Between arm64 and amd64
**arm64**
- Full name: Advanced RISC Machine 64-bit
- Main usage: Primarily used in mobile devices, embedded systems, and some new servers and desktop computers.
- Advantages: Low power consumption, high efficiency, suitable for battery-driven and thermally sensitive devices.
- Main manufacturers: Apple, Qualcomm, Hisilicon, Feiteng, and more.
Before installing any software, you need to know what architecture your computer runs on (such as x86_64/amd64 or aarch64/arm64).
**amd64**
- Full name: AMD 64-bit, also known as x86_64
- Main usage: Mainly used in desktop computers, laptops, and servers.
- Advantages: High performance, suitable for compute-intensive applications.
- Main manufacturers: Intel and AMD.
**How to check:**
The most significant differences between them lie in instruction sets and application scenarios. amd64 is typically used in computers and servers with high-performance requirements, while arm64 is more suitable for scenarios with stricter power consumption requirements.
1. Open a Linux terminal.
2. Type `uname -m` or `arch` and press Enter.
To check your Linux system's processor architecture, you can follow these steps:
1. Open a terminal.
2. Enter `uname -m` or `arch` and press Enter.
3. You will see your processor architecture (possibly x86_64, aarch64, etc.).
You will see an output, and that's your system architecture.
#### Domestic Architecture Support
**Q: I have a domestic architecture. How can I get applications?**
**A:** Currently, the Spark Store supports domestic chips with the **arm** architecture. You can download deb packages (software installation packages) for the arm64 architecture.
> ⚠️ Please note that this is experimental support. If you encounter issues, please provide feedback on the Spark communication platform, QQ groups, or the forum.
- If you see `x86_64`, your system is AMD64 architecture.
- If you see `aarch64`, your system is ARM64 architecture.
#### Dependency Installation Issues
**Q: I encountered an error while installing dependencies**
**A:** If you are using UOS or Deepin, please do not install dependency packages. For Kali Linux/Kdeneon, etc., which are temporarily not supported, you need to compile and install them yourself.
> 💡 When an error occurs, try running `sudo apt update` before attempting to install. If the problem persists, refer to the first question and seek help on the communication platform.
---
#### Submissions and Application Updates
**Q: Where can I submit applications?**
**A:** You can find the "Submit Application" option in the top-right menu of the app store interface.
## System support and installation guide
#### Support for Non-deepin/UOS Users
**Q: I am not a deepin/UOS user. Can I use the Spark Application Store?**
**A:** Yes, you can. If you are using Ubuntu 22.04, you can install it directly. For Ubuntu 20.04/Debian10/Debian11, please install the dependency packages first.
### For Deepin Users
#### Installation Methods
**Q: Can I install with dpkg -i?**
**A:** No! Use `sudo apt install ./xxxx.deb` to install, or use graphical installers like gdebi.
> ⚠️ Using dpkg directly will not handle software dependencies, and this is a common mistake.
#### For Deepin V20 Users
#### System Updates
**Q: Will the Spark Store affect normal system updates?**
**A:** No, the Spark Store separates application sources from system sources and will not affect regular system updates.
1. **Install Dependencies**
Open terminal and execute:
#### Reporting Issues and Application Removal
**Q: Some applications are outdated or no longer working, and I want them removed**
**A:** You can report issues [here](https://gitee.com/deepin-community-store/software_-issue).
```shell
sudo apt install git qt5-default debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev fakeroot qtwayland5 qtwayland5-dev-tools dde-qt5wayland-plugin libqt5svg5*
```
#### Installing the Spark Application Store
If you want to install the Spark Application Store, please open the [Release page](https://gitee.com/deepin-community-store/spark-store/releases), find the latest version, and choose the installation package suitable for your current system.
2. **Download and Install**
> ⚠️ Special Note: If you are using Debian 10/Debian 11 or Ubuntu 20.04, you may need to download additional dependency supplement packages. After downloading the dependency packages, unzip multiple times until you see the software usage instructions inside. For operating system versions after Ubuntu 22.04, you do not need to install dependency packages. Follow the above instructions to directly install the main program.
Please visit [Spark App Store's Release page](https://gitee.com/deepin-community-store/spark-store/releases) and download the latest version suitable for Deepin. Install it to use.
Assuming you download it to the user directory under the Downloads folder, we recommend using APT tools for installation:
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
### For Ubuntu Users
#### For Ubuntu 20.04 Users
1. **Download Dependencies**
* Visit [Spark App Store's dependency download page](https://spark-app.store/download_dependencies_latest), download the latest dependencies.
* Unzip the dependencies multiple times until you can see many installation packages ending with .deb.
* Install all dependencies at once, following the instructions in the dependency package.
2. **Download and Install**
Visit [Spark App Store's Release page](https://gitee.com/deepin-community-store/spark-store/releases), download and install.
Assuming you download it to the user directory under the Downloads folder, we recommend using APT tools for installation:
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
#### For Ubuntu 22.04 Users
1. **Install Dependencies**
Open terminal and execute:
```shell
sudo apt install git qtbase5-dev debhelper pkg-config qtchooser libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5concurrent5 libdtkcore-dev libdtkgui-dev libdtkwidget-dev qttools5-private-dev libnotify-dev qtwebengine5-dev qt
webengine5-dev fakeroot qtwayland5 qtwayland5-dev-tools
```
2. **Download and Install**
Visit [Spark App Store's Release page](https://gitee.com/deepin-community-store/spark-store/releases), download and install.
Assuming you download it to the user directory under the Downloads folder, we recommend using APT tools for installation:
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
Certainly, here's the English translation of the additional text:
---
### For Debian 11 Users
1. **Download Dependencies**
* Please visit the [Spark App Store's dependency download page](https://spark-app.store/download_dependencies_latest) to download the latest dependencies.
* Unzip the dependencies multiple times until you see many installation packages ending with .deb.
* Install all dependencies at once, following the instructions in the dependency package.
2. **Download and Install**
Please visit the [Spark App Store's Release page](https://gitee.com/deepin-community-store/spark-store/releases) and download. Install it to use.
---
## Frequently Asked Questions (FAQ)
Please refer to the [Spark App Store FAQ and Support Guide](https://gitee.com/deepin-community-store/spark-store/blob/dev/FAQ.md).
You can also check the [Chinese version](https://gitee.com/deepin-community-store/spark-store/blob/dev/FAQ.zh.md) here.
---
## Contact and Feedback
- If you have any questions or suggestions, please submit them via email or on our [Gitee page](https://gitee.com/deepin-community-store/spark-store/issues).
- If you want to follow our development progress, you can go to the [Spark App Store Board](https://gitee.com/deepin-community-store/spark-store/board) for more information.
- Our [Forum](https://www.deepinos.org/)
- Our [QQ Group](https://blog.shenmo.tech/post/%E6%95%85%E9%9A%9C%E5%85%AC%E5%91%8A/)
---