spark-store-project/spark-store
13
0
Fork 0
mirror of https://gitee.com/spark-store-project/spark-store synced 2025-01-12 05:08:27 +08:00
Code Issues 2 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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

91
FAQ.md Normal file
View File

@ -0,0 +1,91 @@
# FAQ
## Spark App Store FAQ and Support Guide
### Introduction
The Spark App Store is an application store aimed at Linux users and supports multiple Linux distributions. Below are some commonly asked questions and solutions. Please note that this document is primarily intended for ordinary users who are not familiar with Linux and the APT package management system.
---
### Communication and Feedback
**Q: Where can I join the community group?**
**A:** You can click [here](https://www.deepinos.org/) to enter the main communication platform of the Spark Store.
> ⚠️ If the above link doesn't work, you can also join our QQ groups as an alternative. The group numbers are 872690351 and 865927727. We also offer forums for communication.
#### Differences Between arm64 and amd64
arm64
* Full Name: Advanced RISC Machine 64-bit
* Main Use: 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 heat-sensitive devices.
* Main Manufacturers: Apple, Qualcomm, HiSilicon, Phytium, etc.
amd64
* Full Name: AMD 64-bit, also known as x86_64
* Main Use: Primarily used in desktop computers, laptops, and servers.
* Advantages: High performance, suitable for computation-intensive applications.
* Main Manufacturers: Intel and AMD.
* The main differences between the two are in the instruction sets and application scenarios. amd64 is usually used for high-performance computers and servers, while arm64 is more commonly used in power-sensitive settings.
#### How to Check:
Linux:
- Open the terminal.
- Type `uname -m` or `arch` and press Enter.
- You will see your processor architecture (possibly x86_64, aarch64, etc.).
---
### Domestic Architecture Support
**Q: I use a domestic chip architecture, how can I get applications?**
**A:** Currently, Spark Store supports **arm** architecture for domestic chips. You can download deb packages suitable for arm64 architecture.
> ⚠️ Please note that this is experimental support. If you encounter any issues, please provide feedback via Spark's communication platform, QQ group, or forums.
---
### Dependency Issues
**Q: I get errors when installing dependencies**
**A:** If you are using UOS or deepin, please do not install the dependency packages. For Kali Linux/Kdeneon etc., temporary support is not available, please compile and install yourself.
> 💡 If errors occur, try running `sudo apt update` before attempting the installation again. If the issue persists, refer to the first question and seek help on the community platform.
---
### Submission and App Updates
**Q: Where can I submit applications?**
**A:** You can find the "Submit Application" option in the upper-right corner menu of the app store interface.
---
### Support for Non-deepin/UOS Users
**Q: I'm not a deepin/UOS user; can I use the Spark App Store?**
**A:** Yes, you can directly install if you're using Ubuntu 22.04. For Ubuntu 20.04/Debian10/Debian11, please install the dependencies first.
---
### Installation Methods
**Q: Can I use dpkg -i for installation?**
**A:** No! Use `sudo apt install ./xxxx.deb` to install, or use graphical installers like gdebi.
> ⚠️ Using dpkg directly will not handle software dependencies, which is a common mistake.
---
### System Updates
**Q: Will the Spark Store affect normal system updates?**
**A:** No, the Spark Store has separated its application sources from system sources and will not affect regular system updates.
---
### Reporting Issues and Removing Apps
**Q: Some apps are outdated or inactive, and I want them removed**
**A:** You can report issues [here](https://gitee.com/deepin-community-store/software_-issue).
---
### Installing Spark App Store
If you wish to install the Spark App Store, please visit the [Release page](https://gitee.com/deepin-community-store/spark-store/releases), find the latest version, and choose the package suitable for your current system.
> ⚠️ Special Note: If you are using Debian10/Debian11 or Ubuntu 20.04, you may need to download additional dependency packages. After downloading, unzip multiple times until you see the software user guide. For operating systems later than Ubuntu 22.04, you do not need to install dependency packages. Just follow the steps above to install the main program directly.
---

90
FAQ.zh.md Normal file
View File

@ -0,0 +1,90 @@
# FAQ
## 星火应用商店FAQ与支持指南
### 简介
星火应用商店是一个面向 Linux 用户的应用商店，支持多种不同的 Linux 发行版。以下是一些常见问题及解决方案。请注意，该文档主要面向对 Linux 和 APT 软件包管理系统不熟悉的普通用户。
---
### 交流与反馈
**Q: 在哪进交流群？**
**A:** 你可以点击[这里](https://www.deepinos.org/)进入星火商店的主交流平台。
> ⚠️ 如果上面的链接无法使用，你还可以加入我们的 QQ 群作为备选方案，群号是 872690351 和 865927727。我们还提供论坛作为交流平台。
arm64与amd64的区别
arm64
* 全称: Advanced RISC Machine 64-bit
* 主要用途: 主要应用于移动设备、嵌入式系统以及一些新型的服务器和桌面计算机。
* 优势: 低功耗、高效率，适合用在电池驱动和热敏感的设备。
* 主要生产商: 苹果、高通、海思、飞腾等。
amd64
* 全称: AMD 64-bit, 也被称为 x86_64
* 主要用途: 主要应用于桌面计算机、笔记本以及服务器。
* 优势: 高性能，适用于计算密集型应用。
* 主要生产商: Intel和AMD。
* 两者最主要的不同在于指令集和应用场景。amd64通常用于高性能需求的计算机和服务器，而arm64则更多应用于功耗要求更严格的场合。
查看方法：
Linux：
- 打开终端。
- 输入 uname -m 或 arch 并按回车。
- 你将看到你的处理器架构（可能是 x86_64, aarch64 等）。
---
### 国产架构支持
**Q: 我是国产架构，怎么获取应用？**
**A:** 目前，星火商店支持**arm**架构的国产芯片。你可以下载适用于 arm64 架构的deb包（软件安装包）。
> ⚠️ 请注意，这是实验性的支持。如果遇到问题，请在星火交流平台、QQ群或论坛向我们反馈。
---
### 安装依赖问题
**Q: 安装依赖包出现错误**
**A:** 如果你使用UOS或deepin，请不要安装依赖包。对于Kali Linux/Kdeneon等，暂时不支持，请自行编译安装。
> 💡 出现错误时，尝试运行 `sudo apt update` 后再尝试安装。如果问题仍然存在，请参考第一条，进入交流平台寻求帮助。
---
### 投稿与应用更新
**Q: 在哪里投稿？**
**A:** 你可以在应用商店界面的右上角菜单找到“投递应用”的选项。
---
### 非deepin/UOS用户支持
**Q: 我不是deepin/UOS用户，可以使用星火应用商店吗？**
**A:** 可以，如果你是使用 Ubuntu 22.04，请直接安装。对于 Ubuntu 20.04/Debian10/Debian11，请先安装依赖包。
---
### 安装方法
**Q: 我可以用dpkg -i安装吗？**
**A:** 不可以！使用 `sudo apt install ./xxxx.deb` 来安装，或者使用gdebi等图形化的安装器。
> ⚠️ 直接使用dpkg是不会处理软件依赖的，这是一个常见的错误。
---
### 系统更新
**Q: 星火商店会影响系统正常更新吗？**
**A:** 不会，星火商店已经将应用源与系统源分开，不会影响系统的正常更新。
---
### 报告问题和应用下架
**Q: 有些应用已经过时或者失效了，我想让他下架**
**A:** 你可以前往 [这里](https://gitee.com/deepin-community-store/software_-issue) 报告问题。
---
### 安装星火应用商店
如果你想安装星火应用商店，请打开[Release页面](https://gitee.com/deepin-community-store/spark-store/releases)，找到最新版本，并选择适用于当前系统的安装包下载。
> ⚠️ 特别提示: 如果你在使用 Debian10/Debian11 或 Ubuntu 20.04，你可能额外下载依赖补充包。您需要在下载完依赖包后，解压多次一直到看到内部的软件使用说明，对于 Ubuntu22.04 以后的操作系统版本，您无需安装依赖包，您需要按照上面的操作直接安装本体程序。
---

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/)
---

261
README.zh.md
View File

@ -2,175 +2,162 @@
[![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)
## 简介
国内的Linux应用比较少，wine应用难以获取，优质工具分散在民间各大论坛，无法形成合力，难以改善生态
生态构建需要的不是某一方的单打独斗，而是人人行动起来，汇聚星火，产生燎原之势
我们创建了这个应用商店，广泛收录大家需要的软件包，搜集优质小工具，主动适配wine应用，存放到储存库供大家获取
发行版支持：
* amd64: deepin 20 / deepin 23 / Ubuntu 22.04 / UOS家庭版20
* arm64: UOS专业版1060 / Ubuntu 22.04 / deepin 23
**请注意：本程序不包含任何保证，若你要在UOS专业版上使用，请确保你打开了开发者模式且拥有排查错误的能力，风险自负！**
## 关于协作：分支相关的文档见 [这里](https://deepin-community-store.gitee.io/spark-wiki/#/Dev/Spark-Store-Git-Repo)
欢迎来到星火应用商店！这是一个为Linux用户设计的应用商店，旨在解决Linux生态下应用分散、难以获取的问题。无论你是使用什么类型的Linux发行版，这里都有可能找到适合你的软件包。
希望看到这里的人也可以加入我们的队伍，开发或者投递应用都很欢迎，共同构建Linux应用生态
Linux 应用的数量相对有限，Wine 软件的可获得性也颇为困难。优秀的开发和工具资源散布在各大社区和论坛之间，这种分散化让整个生态系统难以得到全面的提升。
在这里追踪我们的Issue处理情况 https://gitee.com/deepin-community-store/spark-store/board
生态系统的构建并非依赖个体的孤立努力，而需要全社区共同参与。只有当大家的“星火”聚集一处，方可引发“燎原之势”。
如果有想要提交的软件包，请 [在这里投稿](https://upload.deepinos.org/index)
为了改善这一现状，我们推出了这个应用商店。我们广泛地收录了各种用户需求的软件包，汇集了高质量的小工具，并主动对 Wine 应用进行了适配，一切都储存在我们的软件库中，以便用户方便地获取。
**当前支持的Linux发行版包括：**
- **amd64架构：** deepin 20 / deepin 23 / Ubuntu 20.04 / Ubuntu 22.04 / UOS家庭版20
- **arm64架构：** UOS专业版1060 / Ubuntu 22.04 / deepin 23
> 特别说明：我们还支持所有版本高于Ubuntu 22.04的Ubuntu操作系统，例如Ubuntu 22.10、23.04、23.10等。
**重要须知：** 本软件不提供任何形式的保证。若您计划在UOS专业版上使用，请务必了解并启用开发者模式。请确保您具备基础的故障排查能力。需要明确的是，我们没有在UOS操作系统上进行广泛的测试。因此，使用星火客户端可能会导致一系列问题，如系统更新失败、数据丢失等，所有风险需由用户自行承担。
## 🙌 简单的开始
如果想安装 `星火应用商店` ，请打开右侧的 [Release] 页面，找到最新版本，并选择适用于当前系统的安装包下载。
## 关于团队协作：分支管理相关的详细文档可参见 [此链接](https://deepin-community-store.gitee.io/spark-wiki/#/Dev/Spark-Store-Git-Repo)。
如果你在使用 `Debian 11/Ubuntu 20.04`，你需要额外下载[依赖补充包](https://zunyun01.store.deepinos.org.cn/spark-store-dependencies-kylin.zip)
我们热忱欢迎您加入我们的开发团队。无论您是想参与开发，还是想提交应用，都能在这里找到属于您的一席之地，共同推动Linux应用生态的发展。
---
#### 编译安装
您可以通过以下链接，实时跟踪我们的Issue处理状态：[Gitee Issue看板](https://gitee.com/deepin-community-store/spark-store/board)。
**dev分支用于开发，Flamescion分支是amd64,Reason分支是aarch64**。然而，绝大多数情况下，Flamescion和Reason的内容是一致的
Deepin V20/UOS 21 系统下, 安装依赖
```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*
```
然后
```shell
git clone https://gitee.com/deepin-community-store/spark-store.git
cd spark-store
dpkg-buildpackage -j
```
或者： 编译并安装
```shell
git clone https://gitee.com/deepin-community-store/spark-store.git
cd spark-store
./build_and_install.sh
```
## EULA
这里是我们的[EULA](https://mzh.moegirl.org.cn/%E4%BC%98%E8%8F%88%C2%B7%E5%8A%B3%E4%BC%A6%E6%96%AF)
若您有软件包想要提交，敬请 [点击此处进行投稿](https://upload.deepinos.org/index)。
## 🚀 协作
非常感谢有兴趣的开发者或爱好者参与 `星火应用商店` 项目，分享你的见解与思路。
### 论坛
https://www.deepinos.org/
#### QQ群：
https://blog.shenmo.tech/post/%E6%95%85%E9%9A%9C%E5%85%AC%E5%91%8A/
## FAQ
### 星火应用商店FAQ与支持指南
## 目录
#### 简介
星火应用商店是一个面向 Linux 用户的应用商店，支持多种不同的 Linux 发行版。以下是一些常见问题及解决方案。请注意，该文档主要面向对 Linux 和 APT 软件包管理系统不熟悉的普通用户。
- [确定你的系统架构](#确定你的系统架构)
- [系统支持与安装指引](#系统支持与安装指引)
- [对于 Deepin / UOS 用户](#对于deepin用户)
- [对于 Ubuntu 用户](#对于ubuntu用户)
- [对于 Debian 用户](#对于debian用户)
- [常见问题（FAQ）](#常见问题faq)
- [联系与反馈](#联系与反馈)
---
#### 交流与反馈
**Q: 在哪进交流群？**
**A:** 你可以点击[这里](https://www.deepinos.org/)进入星火商店的主交流平台。
> ⚠️ 如果上面的链接无法使用，你还可以加入我们的 QQ 群作为备选方案，群号是 872690351 和 865927727。我们还提供论坛作为交流平台。
## 确定你的系统架构
arm64与amd64的区别
在安装任何软件之前，你需要知道你的计算机运行的是哪种架构（如x86_64/amd64或aarch64/arm64）。
arm64
**如何检查：**
* 全称: Advanced RISC Machine 64-bit
* 主要用途: 主要应用于移动设备、嵌入式系统以及一些新型的服务器和桌面计算机。
* 优势: 低功耗、高效率，适合用在电池驱动和热敏感的设备。
* 主要生产商: 苹果、高通、海思、飞腾等。
1. 打开Linux终端。
2. 输入 `uname -m` 或 `arch` 并按回车。
amd64
你会看到一个输出，这就是你的系统架构。
* 全称: AMD 64-bit, 也被称为 x86_64
* 主要用途: 主要应用于桌面计算机、笔记本以及服务器。
* 优势: 高性能，适用于计算密集型应用。
* 主要生产商: Intel和AMD。
* 两者最主要的不同在于指令集和应用场景。amd64通常用于高性能需求的计算机和服务器，而arm64则更多应用于功耗要求更严格的场合。
查看方法：
Linux：
- 打开终端。
- 输入 uname -m 或 arch 并按回车。
- 你将看到你的处理器架构（可能是 x86_64, aarch64 等）。
---
#### 国产架构支持
**Q: 我是国产架构，怎么获取应用？**
**A:** 目前，星火商店支持**arm**架构的国产芯片。你可以下载适用于 arm64 架构的deb包（软件安装包）。
> ⚠️ 请注意，这是实验性的支持。如果遇到问题，请在星火交流平台、QQ群或论坛向我们反馈。
- 如果看到 `x86_64`，你的系统是AMD64架构。
- 如果看到 `aarch64`，你的系统是ARM64架构。
---
#### 安装依赖问题
**Q: 安装依赖包出现错误**
**A:** 如果你使用UOS或deepin，请不要安装依赖包。对于Kali Linux/Kdeneon等，暂时不支持，请自行编译安装。
> 💡 出现错误时，尝试运行 `sudo apt update` 后再尝试安装。如果问题仍然存在，请参考第一条，进入交流平台寻求帮助。
## 系统支持与安装指引
根据你的Linux发行版和系统架构，以下是安装星火应用商店的详细步骤。
### 对于Deepin用户
#### 对于 Deepin V20 用户
1. **安装依赖**
打开终端并执行：
```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*
```
2. **下载并安装**
请访问[星火应用商店的Release页面](https://gitee.com/deepin-community-store/spark-store/releases)并下载适用于Deepin的最新版本。安装后即可使用。
假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
### 对于 Ubuntu 用户
#### 对于 Ubuntu 20.04 用户
1. **下载依赖包**
* 请访问[星火应用商店依赖包下载页面](https://spark-app.store/download_dependencies_latest)， 下载最新的依赖包。
* 请多次解压依赖包，直到你可以看到诸多以 deb 结尾的安装包。
* 依据依赖包内的说明，一次性安装所有的依赖包。
2. **下载并安装**
请访问[星火应用商店的Release页面](https://gitee.com/deepin-community-store/spark-store/releases)，下载并安装。
假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
#### 对于 Ubuntu 22.04 用户
1. **安装依赖**
打开终端并执行：
```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*
```
2. **下载并安装**
如果你是Ubuntu 22.04用户，请访问[星火应用商店的Release页面](https://gitee.com/deepin-community-store/spark-store/releases)，下载并安装。
假设您下载到用户目录下的 Downloads 文件夹， 我们推荐您使用 APT 工具安装：
```shell
cd ~/Downloads
sudo apt install ./spark-store*.deb
```
### 对于Debian 11用户
1. **下载依赖包**
* 请访问[星火应用商店依赖包下载页面](https://spark-app.store/download_dependencies_latest)， 下载最新的依赖包。
* 请多次解压依赖包，直到你可以看到诸多以 deb 结尾的安装包。
* 依据依赖包内的说明，一次性安装所有的依赖包。
2. **下载并安装**
请访问[星火应用商店的Release页面](https://gitee.com/deepin-community-store/spark-store/releases)并下载，安装后即可使用。
---
#### 投稿与应用更新
**Q: 在哪里投稿？**
**A:** 你可以在应用商店界面的右上角菜单找到“投递应用”的选项。
## 常见问题（FAQ）
请参见[星火应用商店FAQ与支持指南](https://gitee.com/deepin-community-store/spark-store/blob/dev/FAQ.md)。
在这里可以查阅[中文版本](https://gitee.com/deepin-community-store/spark-store/blob/dev/FAQ.zh.md)。
---
#### 非deepin/UOS用户支持
**Q: 我不是deepin/UOS用户，可以使用星火应用商店吗？**
**A:** 可以，如果你是使用 Ubuntu 22.04，请直接安装。对于 Ubuntu 20.04/Debian10/Debian11，请先安装依赖包。
## 联系与反馈
- 如果您有任何问题或建议，请通过邮件或在[Gitee页面](https://gitee.com/deepin-community-store/spark-store/issues)上提交问题。
- 如果你想关注我们的开发进度，可以跳转[星火应用商店Board](https://gitee.com/deepin-community-store/spark-store/board)获取更多信息。
- 我们的[论坛](https://www.deepinos.org/)
- 我们的[QQ群](https://blog.shenmo.tech/post/%E6%95%85%E9%9A%9C%E5%85%AC%E5%91%8A/)
---
#### 安装方法
**Q: 我可以用dpkg -i安装吗？**
**A:** 不可以！使用 `sudo apt install ./xxxx.deb` 来安装，或者使用gdebi等图形化的安装器。
> ⚠️ 直接使用dpkg是不会处理软件依赖的，这是一个常见的错误。
---
#### 系统更新
**Q: 星火商店会影响系统正常更新吗？**
**A:** 不会，星火商店已经将应用源与系统源分开，不会影响系统的正常更新。
---
#### 报告问题和应用下架
**Q: 有些应用已经过时或者失效了，我想让他下架**
**A:** 你可以前往 [这里](https://gitee.com/deepin-community-store/software_-issue) 报告问题。
---
#### 安装星火应用商店
如果你想安装星火应用商店，请打开[Release页面](https://gitee.com/deepin-community-store/spark-store/releases)，找到最新版本，并选择适用于当前系统的安装包下载。
> ⚠️ 特别提示: 如果你在使用 Debian10/Debian11 或 Ubuntu 20.04，你可能额外下载依赖补充包。您需要在下载完依赖包后，解压多次一直到看到内部的软件使用说明，对于 Ubuntu22.04 以后的操作系统版本，您无需安装依赖包，您需要按照上面的操作直接安装本体程序。
---